How to integrate Clarify MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Clarify account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Clarify MCP with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Clarify with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Clarify

Ask your agent to connect to Clarify, or simply request any Clarify-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Clarify connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Clarify or request any Clarify-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

Way Forward

With Clarify connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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.

FRAMEWORKS

How to build Clarify MCP Agent with another framework

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. Hermes 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