How to connect CleverReach to Claude

Connect Claude Web, Desktop and Cowork to CleverReach MCP. List cleverreach subscriber groups needing cleanup, create a cleverreach campaign for new subscribers, and more using natural language, with authentication handled for you.

CleverReach logoCleverReach
Oauth2

CleverReach is an email marketing platform for managing subscribers, campaigns, reports, and signup forms. It helps teams run targeted email campaigns and track their results in one place.

86 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 CleverReach account to Claude via Composio Connect, enabling it to list CleverReach subscriber groups needing cleanup, create a CleverReach campaign for new subscribers, review CleverReach campaign delivery reports today, 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 CleverReach with

Connecting CleverReach 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 CleverReach account

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

For example, ask Claude to:

  • "List CleverReach subscriber groups needing cleanup"
  • "Create a CleverReach campaign for new subscribers"
  • "Review CleverReach campaign delivery reports today"

It will prompt you to authenticate and authorize access.

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

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

The CleverReach MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your CleverReach account. It provides structured and secure access to your subscriber groups, email campaigns, reports, forms, and marketing data, so your agent can manage subscribers, organize audiences, create campaign content, review performance, and maintain email lists on your behalf.

  • Subscriber and group management: Have your agent create, update, bulk upsert, clone, tag, filter, and delete subscribers across CleverReach groups.
  • Audience segmentation: Let the agent create reusable filters, find subscribers that match specific rules, count contacts by tags, and review group statistics.
  • Campaign and content creation: Direct your agent to create mailing campaigns, reusable mailing templates, and reusable content items for your CleverReach marketing work.
  • Marketing performance and records: Instruct your agent to retrieve campaign details, group statistics, filter metrics, receiver events, and subscriber order history.
  • List protection and signup forms: Have your agent check, add, or remove blacklist entries and retrieve embeddable HTML, JavaScript, and CSS for existing CleverReach forms.

Troubleshooting

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

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

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

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

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

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

3. Why does the CleverReach authorization link not work?

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

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

4. Why do CleverReach actions fail after they worked before?

The CleverReach connection can expire or lose permission.

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

5. How do I switch to a different CleverReach account?

Claude can manage the CleverReach connection for you.

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

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

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

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

Supported Tools

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

Add Blacklist Entries

Add email addresses to the account-wide CleverReach blacklist in one provider batch request.

Add Blacklist Entry

Add one email address to the global blacklist when group_id is omitted, or to a group-specific blacklist when it is supplied.

Add Group Receiver Tags

IRREVERSIBLE AUTOMATION WARNING: add tags to one receiver through a specific group route.

Add Receiver Tags

Add tags to one receiver through the account-wide receiver route.

Bulk Update Receivers

Update existing receivers in one provider batch for a group.

Bulk Upsert Receivers

Create or update receivers in one provider batch for a group.

Change Receiver Email

Change one receiver's email address.

Clone Receiver

Copy a receiver to a target group under a new email address.

Count Receivers By Tags

Count receivers with one tag using a GET query, or with a tag constellation using a read-like POST.

Create Attribute

Create a global or group-local CleverReach receiver attribute.

Create Filter

Create a reusable CleverReach filter or segment in one receiver group.

Create Group

Create a CleverReach receiver group and return its group ID for subsequent subscriber operations.

Create Mailing

Create a CleverReach mailing campaign definition.

Create Mailing Template

Create a reusable CleverReach mailing template.

Create My Content

Create a reusable CleverReach "My Content" item that references a URL.

Create Receiver

Create a subscriber in one CleverReach group.

Create Receiver Event

IRREVERSIBLE: permanently add an event to one CleverReach receiver.

Create Receiver Order

MUTATES ORDER HISTORY: add an order to one CleverReach receiver globally or within a group.

Create Receivers

Create up to 50 subscribers in one CleverReach group and return a separate success or failure result for each receiver.

Delete Attribute

Permanently delete a CleverReach global or group-local attribute.

Delete Blacklist Entries

Permanently delete 1-50 exact email addresses sequentially from the global account blacklist, or only from one group's blacklist when group_id is supplied.

Delete Blacklist Entry

Permanently remove one email address from the global CleverReach blacklist, or from a group blacklist when group_id is supplied.

Delete Filter

Permanently delete a CleverReach filter or segment.

Delete Group

Permanently delete one CleverReach receiver group by ID.

Delete Mailing Channel

Permanently delete one CleverReach mailing channel/category.

Delete My Content

Permanently delete one CleverReach "My Content" item by exact ID.

Delete Receiver Account-Wide

Permanently delete one exact receiver at account level.

Delete Receiver Order

IRREVERSIBLE: permanently delete one CleverReach receiver order globally or within a group using its internal id from LIST_RECEIVER_ORDERS, not the caller-defined order_id.

Delete Receivers Account-Wide

Permanently delete a non-empty explicit list of exact receivers account-wide.

Delete Report

Permanently and irreversibly delete one report and its historical analytics by exact report or mailing ID.

Filter Receivers

Return one bounded page of receivers matching temporary CleverReach filter rules.

Get Attribute

Return one CleverReach global attribute by ID.

Get Attribute Limits

Show the attribute limits applied to the connected CleverReach account.

Get Blacklist Entry

Check whether an exact email address is on the account-wide CleverReach blacklist and return its blacklist details when present.

Get Filter

Get one CleverReach group filter or segment.

Get Filter Metrics

Return statistics or a receiver count for one CleverReach group filter.

Get Form Embed Code

Return embeddable HTML, JavaScript, and CSS for an existing legacy CleverReach form, with optional branding controls.

Get Group

Return one receiver group by its CleverReach group ID.

Get Group Stats

Return either standard or advanced CleverReach statistics for one receiver group.

Get Mailing

Return one CleverReach mailing campaign by its mailing ID.

Get Mailing Channel

Return one CleverReach mailing channel or category by ID.

Get My Content

Return one CleverReach "My Content" item by ID.

Get Random Mailing Receiver

Return a random receiver from a CleverReach mailing audience for preview purposes.

Get Receiver

Return one receiver by ID or exact email address.

Get Receiver Attributes

Get attribute values for a CleverReach receiver, optionally in one group.

Get Receiver Tags

Return all tags currently set on one receiver, optionally filtered by origin.

Get Report

Return one mailing report by report or mailing ID, including split-test versions when present.

Get Report Stats

Return one selected statistics view for a mailing report, such as links, countries, clients, traffic, or daily activity.

List Attributes

Return a locally bounded set of global attributes or local attributes for one CleverReach group.

List Blacklist Entries

Return a locally bounded set of entries on the global CleverReach blacklist, or on a specific group blacklist when group_id is supplied.

List Bounced Receivers

Return one bounded page of receivers with a bounce date and an opaque cursor for the next page.

List Bounces

Return one page of up to 500 account-wide CleverReach bounce records.

List Filter Receivers

Return one bounded page of receivers matching a saved CleverReach filter.

List Filters

Return a locally bounded set of CleverReach filters or segments for one receiver group.

List Forms

Return a locally bounded set of legacy CleverReach forms globally or for a supplied group.

List Groups

Return a locally bounded set of receiver groups (lists) in the connected CleverReach account, optionally ordered by creation or change time.

List Mailing Channels

Return a locally bounded set of CleverReach mailing channels, also called categories.

List Mailing Links

Return the links CleverReach recorded for one mailing.

List Mailing Orders

Return a locally bounded set of orders attributed to a CleverReach report or mailing.

List Mailings

Return campaigns filtered by delivery state, channel, or the state's time window.

List Mailing Templates

Return locally bounded categories and either agency-managed or user-owned CleverReach templates.

List My Content

Return a locally bounded set of reusable CleverReach "My Content" items.

List Receiver Events

Return a locally bounded set of events recorded for one CleverReach receiver, either account-wide or in a specific group.

List Receiver Groups

Return a locally bounded set of group IDs to which a receiver is allocated, filtered by membership state.

List Receiver Orders

Return a locally bounded set of orders recorded for one CleverReach receiver, globally or in a specific group.

List Receivers

Return one page of receivers in a CleverReach group, optionally filtered by subscription state, email addresses, or receiver IDs.

List Receiver Tags

Return a locally bounded set of receiver tags already used in the account, optionally filtered by origin.

List Report Receivers

Return one page of receivers in a report for a delivery or engagement state such as opened, clicked, bounced, or unsubscribed.

List Reports

Return one page of mailing reports filtered by date range, group, or channel.

List Tags

Return one page of account tags or the account's supertags.

Remove Receiver From Group

Remove one exact receiver from one specified group.

Remove Receivers From Group

Remove a non-empty explicit list of exact receivers from one specified group.

Remove Receiver Tags

Remove specified tags from one receiver.

Send Mailing Preview

Immediately deliver a preview email for one mailing to the specified CleverReach account-user addresses.

Set Receiver Attribute

Update one attribute value on a CleverReach receiver at account or group scope.

Set Receiver Status

Activate or deactivate one receiver in a CleverReach group, changing whether the subscriber is active for mailings.

Update Attribute

Update a CleverReach global or group-local attribute.

Update Blacklist Entry

Update the comment on one account-wide CleverReach blacklist entry, identified by its email address.

Update Filter

Update a CleverReach filter or segment in one receiver group.

Update Group

Update the name, notes, lock setting, or backup setting of an existing CleverReach receiver group.

Update Mailing

Update the content, audience, sender, tracking settings, or tags of an existing CleverReach mailing campaign without sending it.

Update My Content

Update supplied fields of one CleverReach "My Content" item.

Update Receiver

Update lifecycle timestamps, profile attributes, tags, or orders for one receiver in a CleverReach group without changing the email.

Update Receiver Order

IRREVERSIBLE MUTATION: replace the documented details of one CleverReach order item by its internal id from LIST_RECEIVER_ORDERS, not by the caller-defined order_id.

Validate Blacklist Emails

Filter up to 1000 email addresses against the global or group CleverReach blacklist without changing blacklist state.

Validate Receiver Emails

Submit up to 1000 email addresses and return CleverReach's valid-address result.

FAQ

Frequently asked questions

With a standalone CleverReach MCP server, the agents and LLMs can only access a fixed set of CleverReach tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from CleverReach 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 CleverReach tools.

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

Start with CleverReach.It takes 30 seconds.

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

Start building