# How to connect Modem MCP to Claude ```json { "title": "How to connect Modem MCP to Claude", "toolkit": "Modem MCP", "toolkit_slug": "modem_mcp", "framework": "Claude Cowork", "framework_slug": "claude-cowork", "url": "https://composio.dev/toolkits/modem_mcp/framework/claude-cowork", "markdown_url": "https://composio.dev/toolkits/modem_mcp/framework/claude-cowork.md", "updated_at": "2026-09-24T15:54:58.576Z" } ``` ## Introduction Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf. This guide walks you through the easiest and most secure way to connect your Modem account to Claude via Composio Connect, enabling it to search customer feedback for refund complaints, start durable agent conversation about onboarding, create topic for recurring payment issues, and more such actions on your behalf without compromising your account security. Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three. ## Also integrate Modem MCP with - [ChatGPT](https://composio.dev/toolkits/modem_mcp/framework/chatgpt) - [Hermes](https://composio.dev/toolkits/modem_mcp/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/modem_mcp/framework/atomic-agent) ## Connect Modem MCP to Claude Cowork ### Connecting Modem to Claude Web, Desktop, and Cowork Two ways to add the Composio connector. Pick whichever you prefer. ### 1. Add with one click Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2. [Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Composio&connectorUrl=https%3A%2F%2Fconnect.composio.dev%2Fmcp) ### Add manually In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top. Click Add custom connector and paste in the Composio MCP server URL: ```bash https://connect.composio.dev/mcp ``` ## What is the Modem MCP server, and what's possible with it? The Modem MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Modem account. It provides structured and secure access so your agent can perform Modem operations on your behalf. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `MODEM_MCP_ADD_PEOPLE_TO_COMPANY` | Add people to company | Associate one or more people with a company. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | | `MODEM_MCP_BULK_UPDATE_TOPICS` | Bulk update topics | Update multiple topics at once (e.g. archive or re-prioritize a set of topics). Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | | `MODEM_MCP_CREATE_COMPANIES` | Create companies | Create one or more companies in the organization. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | | `MODEM_MCP_MERGE_COMPANIES` | Merge companies | Merge one or more source companies into a target company. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | | `MODEM_MCP_MERGE_PEOPLE` | Merge people | Merge one or more source people into a target person. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | | `MODEM_MCP_MERGE_TOPICS` | Merge topics | Merge one or more source topics into a target topic. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | | `MODEM_MCP_MODEM_AGENT_CANCEL_RUN` | Modem agent cancel run | Cooperatively cancel one exact durable Modem agent run. Completed external actions are not reversed. | | `MODEM_MCP_MODEM_AGENT_GET_RUN` | Modem agent get run | Get the current status and terminal result of a durable Modem agent run. | | `MODEM_MCP_MODEM_AGENT_INVOKE` | Modem agent invoke | Start a durable Modem agent conversation. Returns immediately with conversation_id and run_id; poll modem_agent_get_run for the result. Before your first call, read the skill: `modem_skills({ name: "agent-runs" })`. | | `MODEM_MCP_MODEM_AGENT_SEND_MESSAGE` | Modem agent send message | Start a durable follow-up turn in an existing MCP conversation. | | `MODEM_MCP_MODEM_SKILLS` | Modem skills | Skills that teach you how to use THIS Modem MCP server's tools. Call before your first `search_modem`, `modem_agent_invoke`, or write-tool call, or when unsure which Modem tool to use. Pass `name` for the full skill, one of `search-modem`, `agent-runs`, `write-tools`. Omit `name` to list them with descriptions. This is not the Skills page in dashboard settings. | | `MODEM_MCP_SEARCH_MODEM` | Search modem | Answer a natural-language question about your Modem data and get matching rows back. Read-only. It does not run the full Modem agent or spend agent credits. Send a `question`, or send only the `cursor` from a previous result to fetch its next page. Topic `priority` in the rows is an integer: very_low (-100), low (-50), default (0), high (50), very_high (100). Before your first call, read the skill: `modem_skills({ name: "search-modem" })`. | | `MODEM_MCP_UPDATE_COMPANIES` | Update companies | Update fields on one or more existing companies. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | | `MODEM_MCP_UPDATE_PEOPLE` | Update people | Update fields on one or more existing people. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | | `MODEM_MCP_UPDATE_TOPIC` | Update topic | Update a single topic (priority, lifecycle state, archived status, issue type, or keywords). Before your first call, read the skill: `modem_skills({ name: "write-tools" })`. | ## Supported Triggers None listed. ## Troubleshooting ### 1. Why does Claude not use the Composio connector for Modem? The connector can show as connected, but Claude must use it in each Modem conversation. - Click + at the lower left of the chat, or type /. - Hover Connectors. - Turn on Composio. - Ask Claude to connect to Modem again. ### 2. Why does Claude show an MCP server error before Modem connects? Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Modem. - Check that the connector URL is https://connect.composio.dev/mcp. - Connectors run from Anthropic's cloud, so your device network is usually not the problem. - Add the connector again from Customize > Connectors, then ask Claude to connect Modem. - If it fails again, send the error and the ofid_ reference id to support@composio.dev. ### 3. Why does the Modem authorization link not work? The Composio connector is one server. Your Modem account connects separately when Claude asks for it. - If the browser does not open, or the link expires, ask Claude to retry the Modem connection. - Composio creates a fresh Modem authorization link. - Open that link in your browser and finish the Modem sign-in. ### 4. Why do Modem actions fail after they worked before? The Modem connection can expire or lose permission. - Ask Claude to inspect the Modem connection. - If the connection is unhealthy, disconnect it when Claude prompts you. - Reconnect the Modem account and retry the action. - If Claude shows a permission prompt, approve it before Claude changes data in Modem. - If the action still fails with a permission error, check that the connected account has that permission in Modem itself. ### 5. How do I switch to a different Modem account? Claude can manage the Modem connection for you. - Ask Claude to disconnect or delete the current Modem account. - Ask Claude to connect Modem again. - Open the new Composio authorization link for Modem. - Sign in with the other Modem account in the browser. - After the account connects, ask Claude to retry the Modem task. ### 6. Why is my Modem connection missing in Claude Desktop or on a Team plan? The connector belongs to your Claude account, so your Modem connection works in Claude Web, Desktop, and Cowork. - In Claude Desktop, open Customize > Connectors. - Next to Composio, click ⋮ and click Clear cache. - If Modem tools still do not appear, click ⋮, disconnect, remove the connector, and add it again. - On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Modem. ## Creating MCP Server - Stand-alone vs Composio SDK The Modem MCP server connects Claude Web, Desktop, and Cowork to your Modem account through Composio. Once connected, Claude can use the available Modem tools and triggers to complete tasks on your behalf. ## Complete Code None listed. ## How to build Modem MCP Agent with another framework - [ChatGPT](https://composio.dev/toolkits/modem_mcp/framework/chatgpt) - [Hermes](https://composio.dev/toolkits/modem_mcp/framework/hermes-agent) - [Atomic Agent](https://composio.dev/toolkits/modem_mcp/framework/atomic-agent) ## Related Toolkits - [Google Sheets](https://composio.dev/toolkits/googlesheets) - Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly. - [Notion](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place. - [Airtable](https://composio.dev/toolkits/airtable) - Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations. - [Asana](https://composio.dev/toolkits/asana) - Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals. - [Google Tasks](https://composio.dev/toolkits/googletasks) - Google Tasks is a to-do list and task management tool integrated into Gmail and Google Calendar. It helps you organize, track, and complete tasks across your Google ecosystem. - [Linear](https://composio.dev/toolkits/linear) - Linear is a modern issue tracking and project planning tool for fast-moving teams. It helps streamline workflows, organize projects, and boost productivity. - [Firecrawl](https://composio.dev/toolkits/firecrawl) - Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources. - [Tavily](https://composio.dev/toolkits/tavily) - Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research. - [Jira](https://composio.dev/toolkits/jira) - Jira is Atlassian’s platform for bug tracking, issue tracking, and agile project management. It helps teams organize work, prioritize tasks, and deliver projects efficiently. - [Exa](https://composio.dev/toolkits/exa) - Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows. - [Serpapi](https://composio.dev/toolkits/serpapi) - SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research. - [Clickup](https://composio.dev/toolkits/clickup) - ClickUp is an all-in-one productivity platform for managing tasks, docs, goals, and team collaboration. It streamlines project workflows so teams can work smarter and stay organized in one place. - [Monday](https://composio.dev/toolkits/monday) - Monday.com is a customizable work management platform for project planning and collaboration. It helps teams organize tasks, automate workflows, and track progress in real time. - [Peopledatalabs](https://composio.dev/toolkits/peopledatalabs) - Peopledatalabs delivers B2B data enrichment and identity resolution APIs. Supercharge your apps with accurate, up-to-date business and contact data. - [Snowflake](https://composio.dev/toolkits/snowflake) - Snowflake is a cloud data warehouse built for elastic scaling, secure data sharing, and fast SQL analytics across major clouds. - [Posthog](https://composio.dev/toolkits/posthog) - PostHog is an open-source analytics platform for tracking user interactions and product metrics. It helps teams refine features, analyze funnels, and reduce churn with actionable insights. - [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time. - [Aeroleads](https://composio.dev/toolkits/aeroleads) - Aeroleads is a B2B lead generation platform for finding business emails and phone numbers. Grow your sales pipeline faster with powerful prospecting tools. - [Agiled](https://composio.dev/toolkits/agiled) - Agiled is an all-in-one business management platform for CRM, projects, and finance. It helps you streamline workflows, consolidate client data, and manage business processes in one place. - [Ahrefs MCP](https://composio.dev/toolkits/ahrefs_mcp) - Ahrefs MCP is Ahrefs' hosted MCP server for SEO data and insights. Use it to access backlinks, organic metrics, keyword research, and competitor analysis. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Modem MCP? With a standalone Modem MCP server, the agents and LLMs can only access a fixed set of Modem tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Modem and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with Claude Cowork? Yes, you can. Claude Cowork 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 Modem tools. ### Can I manage the permissions and scopes for Modem while using Tool Router? Yes, absolutely. You can configure which Modem 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. ### How safe is my data with Composio Tool Router? 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 Modem data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)