How to integrate Clarify MCP with Atomic Agent

Connect Atomic Agent to Clarify MCP. List all open deals in pipeline, create follow-up task for acme corp, and more using natural language, with authentication handled for you.

Clarify MCP logoClarify MCP
Dcr Oauth

Clarify MCP is a CRM platform for managing companies, people, deals, meetings, tasks, lists, and campaigns. Use it to centralize CRM data and streamline sales and marketing workflows.

46 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,500+ apps through Composio, including Clarify.

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 Clarify account. See the Atomic Agent documentation for installation instructions.

Also integrate Clarify MCP with

How Atomic Agent connects to Clarify

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 Clarify 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 Clarify. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Clarify 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 Clarify MCP server, and what's possible with it?

The Clarify MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Clarify account. It provides structured and secure access so your agent can perform Clarify operations on your behalf.

Use Clarify from Atomic Agent

With your account connected, ask Atomic Agent to work with Clarify 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 Clarify MCP action and event your agent gets out of the box.

Add-comment

Add a comment to a supported entity.

Create-campaign

Create a new email campaign (sequence) in DRAFT mode.

Create-email-draft

Create an email draft in the user's connected Gmail or Outlook account for them to review, edit, and send themselves.

Create-or-update-agent

Create or update an agent, an autonomous AI assistant.

Create-or-update-artifact

Create a new artifact or write a new version to an existing artifact.

Create-or-update-calendar-event

Create a new calendar event or update an existing one.

Create-or-update-custom-object

Create a new custom object type or update an existing one in the workspace.

Create-or-update-fields

Create new fields or update existing field metadata (name, options, AI config) on any entity (company, person, deal, meeting, or custom object).

Create-or-update-list

Create or update a dynamic list: a saved view whose membership is defined by a SQL query.

Create-or-update-records

Create or update records in Clarify.

Create-or-update-workflow

Create a new workflow or update an existing one.

Delete-agent

Delete an agent by its ID.

Delete-artifact

Delete an artifact by its ID.

Delete-calendar-event

Cancel a calendar event.

Delete-campaign

Delete a campaign by its ID.

Delete-custom-object

Delete a custom object type by its entity identifier.

Delete-fields

Delete one or more custom fields from an existing object (built-in entities like person, company, deal, or custom objects like c_my_object).

Delete-list

Delete a list (saved view) by its ID.

Delete-records

Delete one or more records by their IDs.

Delete-workflow

Delete a workflow by its ID.

Find-leads

Search Clarify's built-in prospect database of companies and people to find new leads matching criteria like industry, location, headcount, job title, seniority, and funding stage, and save (publish) a search the user wants to keep.

Get-agent-runs

List an agent's runs, executions, invocations, and past run history, or fetch one run with its full transcript.

Get-agents

List agents visible to the current user, or fetch a single agent by ID.

Get-artifact-component-doc

Get the full prop contract for one or more Clarify design-system components available to artifacts — each component's summary, a usage snippet, and every prop with its type and allowed values.

Get-artifact-source

Read the current source of an existing artifact — the JSX of its applied version, plus its name and description.

Get-calendar-events

List the current user's calendar events in a time range.

Get-campaign-recipients

List the individual people enrolled in a campaign, with their per-person engagement — who opened, who clicked, who replied, and when.

Get-campaigns

List campaigns in the workspace, or fetch a single campaign by ID with full details.

Get-current-user

Get information about the current authenticated user, including their timezone.

Get-lists

Get list metadata (saved views) for an entity type, or fetch a single list by ID.

Get-records

Retrieve detailed information about specific records by their IDs.

Get-schema

Get the schema for Clarify entities.

Get-workflow-runs

Get execution runs for a workflow.

Get-workflows

Get and search workflows in the workspace, or fetch a single workflow with its full configuration.

Import-leads

Import leads from a tam_company or tam_person search into Clarify.

Import-meeting-transcript

Import a meeting transcript from an external source (Granola, Notion, Circleback).

Manage-access

Manage who can access a specific object — a list, meeting, message, or record (deal, company, person, or a custom object) — by granting, updating, revoking, or reading its access grants, or reassigning its owner.

Merge-records

Merge two or more records into a single primary record in Clarify.

Query-analytics

Execute read-only ClickHouse SQL against the analytics event log.

Query-data

Execute PostgreSQL queries to retrieve data from Clarify.

Read-context

Read Clarify product knowledge and documentation.

Respond-to-calendar-event

RSVP to a calendar event you've been invited to.

Run-workflow

Start a workflow run.

Send-email

Send an email immediately through the user's connected email account.

Submit-feedback

Submit concise feature requests or feedback about MCP tools.

Update-campaign

Update an existing email campaign: rename it, change its target list, adjust the sender, edit its email steps, or configure send time windows.

FAQ

Frequently asked questions

With a standalone Clarify MCP server, the agents and LLMs can only access a fixed set of Clarify tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Clarify and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Clarify tools.

Yes, absolutely. You can configure which Clarify scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Clarify data and credentials are handled as safely as possible.

Start with Clarify MCP.It takes 30 seconds.

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

Start building