How to integrate Twenty MCP with Atomic Agent

Connect Atomic Agent to Twenty MCP. List all open deals closing this month, create a new contact with company, and more using natural language, with authentication handled for you.

Twenty logoTwenty
Api Key

Twenty is the #1 open-source CRM for managing customer relationships. Use it to track contacts, deals, activities, and streamline sales.

23 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Twenty.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Twenty account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Twenty with

How Atomic Agent connects to Twenty

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Twenty to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Twenty. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Twenty account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Twenty MCP server, and what's possible with it?

The Twenty MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Twenty account. It provides structured and secure access to your CRM data, so your agent can create, find, review, update, and delete companies, people, opportunities, and tasks on your behalf.

  • CRM record creation: Have your agent create a company, person, opportunity, or task, either individually or in batches of up to 60 records.
  • Customer and pipeline lookup: Instruct your agent to find and review companies, people, opportunities, or tasks using filters and sorting.
  • Record updates: Let the agent update selected details for an existing company, person, opportunity, or task while leaving other information unchanged.
  • Workspace discovery: Direct your agent to inspect the standard and custom record types and available fields in your workspace before working with your CRM data.
  • CRM data cleanup: Have your agent permanently delete companies, people, opportunities, or tasks that you no longer need.

Use Twenty from Atomic Agent

With your account connected, ask Atomic Agent to work with Twenty in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Twenty action and event your agent gets out of the box.

Batch Create CRM Records

Create 1-60 records of one type.

Create Attached Note

Create a note and attach it to one company, person, or opportunity.

Create Custom Object Record

Create one record in a workspace-defined custom object using its plural API name and arbitrary schema-discovered fields.

Create Note

Create one standalone Twenty note without adding a note-target association.

Create Note Target

Attach an existing note to exactly one company, person, or opportunity.

Create CRM Record

Create one company, person, opportunity, or task using the supported standard fields in the parameter schema.

Create Task Target

Attach an existing task to exactly one company, person, or opportunity.

Delete CRM Record

Permanently delete one company, person, opportunity, or task by UUID.

Get Custom Object Record

Get one record from a workspace-defined custom object by UUID using the object's plural API name from List CRM Objects.

Get Note Target

Get one note-to-record association by UUID.

Get CRM Record

Get one company, person, opportunity, or task by its Twenty UUID, optionally including direct relations.

List Custom Object Records

List records from a workspace-defined custom object using its plural API name, with Twenty filtering, ordering, relation depth, and cursor pagination.

List CRM Fields

List field definitions from the connected Twenty workspace to discover exact field names, types, editability, nullability, uniqueness, and relation targets for schema inspection and filters.

List Notes

List Twenty notes with filtering, ordering, field selection, relation depth, and cursor pagination.

List Note Targets

List associations between notes and companies, people, or opportunities with Twenty filtering, ordering, relation depth, and cursor pagination.

List CRM Objects

List standard and custom object definitions in the connected Twenty workspace for schema inspection.

List CRM Records

List companies, people, opportunities, or tasks with Twenty filter syntax, ordering, relation depth, and forward cursor pagination.

List Task Targets

List associations between tasks and companies, people, or opportunities with Twenty filtering, ordering, relation depth, and cursor pagination.

List Workspace Members

List Twenty workspace members for identity and assignment lookups, with filtering, ordering, relation depth, and cursor pagination.

Update Custom Object Record

Partially update one record in a workspace-defined custom object by UUID.

Update Note

Partially update one Twenty note by UUID; only supplied fields change.

Update Note Target

Partially update one note-to-record association by UUID.

Update CRM Record

Partially update one company, person, opportunity, or task by UUID using the supported standard fields in the parameter schema; only supplied fields change.

FAQ

Frequently asked questions

Start with Twenty.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Twenty tool your agent needs.Free to start.

Start building