X (Twitter)LinkedInGitHubDiscordYouTube

How to connect 2chat to Claude

Connect Claude Web, Desktop and Cowork to 2chat MCP. Add new whatsapp contact for sales lead, list all whatsapp contacts and their details, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
2chat logo 2chat
Api Key

2chat is an API platform for WhatsApp and multichannel text messaging. It streamlines chat automation, group management, and real-time messaging for developers.

5 Tools

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 2chat account to Claude via Composio Connect, enabling it to add new WhatsApp contact for sales lead, list all WhatsApp contacts and their details, check your 2Chat API usage this week, 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 2chat with

Claude CodeOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting 2chat 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

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your 2chat account

Back in Claude, ask it to connect to 2chat or give it any 2chat-related task.

For example, ask Claude to:

  • "Add new WhatsApp contact for sales lead"
  • "List all WhatsApp contacts and their details"
  • "Check your 2Chat API usage this week"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your 2chat account is ready to use.

What is the 2chat Claude Connector, and what's possible with it?

The 2chat MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your 2chat account. It provides structured and secure access to your messaging channels, so your agent can perform actions like sending and receiving WhatsApp messages, managing contacts, monitoring API usage, and automating group workflows on your behalf.

  • Contact management and automation: Quickly add new contacts or retrieve existing ones, allowing your agent to keep your WhatsApp and text channels up to date and organized.
  • API usage monitoring: Effortlessly check your current API usage and quotas, so your agent can help prevent service interruptions or overages.
  • Webhook subscription review: Let your agent list and audit all active webhook subscriptions for your messaging channels, making it easy to monitor integrations and event triggers.
  • Credential validation and account status: Have your agent validate API keys and fetch account information to ensure secure and reliable operation before performing messaging tasks.

Troubleshooting

1. Why does Claude not use the Composio connector for 2chat?

The connector can show as connected, but Claude must use it in each 2chat conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to 2chat again.

2. Why does Claude show an MCP server error before 2chat connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for 2chat.

  • 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 2chat.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the 2chat authorization link not work?

The Composio connector is one server. Your 2chat account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the 2chat connection.
  • Composio creates a fresh 2chat authorization link.
  • Open that link in your browser and finish the 2chat sign-in.

4. Why do 2chat actions fail after they worked before?

The 2chat connection can expire or lose permission.

  • Ask Claude to inspect the 2chat connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the 2chat account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in 2chat.
  • If the action still fails with a permission error, check that the connected account has that permission in 2chat itself.

5. How do I switch to a different 2chat account?

Claude can manage the 2chat connection for you.

  • Ask Claude to disconnect or delete the current 2chat account.
  • Ask Claude to connect 2chat again.
  • Open the new Composio authorization link for 2chat.
  • Sign in with the other 2chat account in the browser.
  • After the account connects, ask Claude to retry the 2chat task.

6. Why is my 2chat connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your 2chat connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If 2chat 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 2chat.
TOOLS

Supported Tools

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

Create Contact

Tool to create a new contact in your 2Chat account.

Get API Usage Info

Tool to retrieve current API usage and account information.

List Contacts

Tool to list all contacts in your 2Chat account.

List Webhook Subscriptions

List all configured webhook subscriptions for WhatsApp and phone call events.

Test API Key

Tool to validate your API key and retrieve account info.

FRAMEWORKS

How to build 2chat MCP Agent with another framework

Claude Code logo

Claude Code

Use 2chat MCP with Claude Code

OpenAI Agents SDK logo

OpenAI Agents SDK

Use 2chat MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use 2chat MCP with Claude Agent SDK

Codex logo

Codex

Use 2chat MCP with Codex

OpenClaw logo

OpenClaw

Use 2chat MCP with OpenClaw

Hermes logo

Hermes

Use 2chat MCP with Hermes

Atomic Agent logo

Atomic Agent

Use 2chat MCP with Atomic Agent

Google ADK logo

Google ADK

Use 2chat MCP with Google ADK

LangChain logo

LangChain

Use 2chat MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use 2chat MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use 2chat MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use 2chat MCP with LlamaIndex

CrewAI logo

CrewAI

Use 2chat MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use 2chat MCP with Pydantic AI

AutoGen logo

AutoGen

Use 2chat MCP with AutoGen

FAQ

Frequently asked questions

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

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 2chat tools.

Yes, absolutely. You can configure which 2chat 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 2chat data and credentials are handled as safely as possible.

Start with 2chat.It takes 30 seconds.

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

Start building