The Customer.io MCP Server
BetaThis feature is new and we're actively working to improve it. Contact us if you'd like to try it out. UpdatedHow it works
Our Model Context Protocol (MCP) Server helps you interact with Customer.io through your favorite AI tools—Claude, Cursor, and so on.
Where you might be able to use our APIs to do some things, the MCP server is a layer of tools that includes features that aren’t possible with our APIs today.
Make sure you trust your AI tools
Our MCP server works with your AI provider of choice and it includes tools that return information about people in your workspace. While our LLM subprocessors don’t store this data, the AI providers you use might. Make sure that you use AI tools that are approved by your organization to ensure the safety of your—and your customers’—data.
What tools does the MCP server support?
The table below shows the tools that are currently available to our MCP server, and the actions that each tool can perform. As we expand the capabilities of our MCP server, we won’t just add more tools, but more actions to the existing tools; this helps us limit the number of tools we provide, so we don’t overwhelm you or your LLM with a lengthy MCP toolchain.
We’re actively working on our MCP server and related tools. If you have a specific MCP feature or use case in mind, let us know!
Tool Name | Description |
---|---|
create | Create new resources like segments, campaigns, and other workspace entities. Action: create_segment |
get | Get detailed information about single resources like user profiles, segments, campaigns etc. Action: get_profile |
integration | This tool helps you integrate Customer.io into mobile and web applications, including authentication and adding necessary code to your app to support push notifications and in-app messages.* Available actions:
sources_list ,
sources_search ,
source_get ,
source_add ,
test_inapp ,
test_push ,
troubleshoot |
list | List workspace resources and metadata, like profile attributes, segments, events etc. Available actions:
list_attributes ,
list_segments ,
list_events |
list_workspaces | Lists the workspaces the user has access to. Always call this first to get a workspace_id for workspace-scoped actions. |
search | Search across documentation and workspace data for specific content and patterns. Available actions:
search_docs ,
search_workspace |
* Summary of tool's description. See the tool in your environment for the full description.
Enable MCP support for your account
You must be an account admin to enable MCP support for your account. This enables the feature for your account, but you and other users still need to set up your clients to use it.
Go to > Account Settings and then click Privacy & Data.
Enable Customer.io MCP.
Set up your MCP client
Before you can use the MCP server, you’ll need to Enable MCP support for your account. If you haven’t done that yet, you won’t see MCP support in your personal settings.
Cursor and other IDEs (Windsurf, VS Code, etc)
Adding MCP support to your integrated development environment (IDE) depends on whether you use Cursor—for which we have a one-click setup—or another tool like Windsurf.
Go to > Personal Settings.
Click the Cursor tab and enable support for your IDE:
- If you use Cursor, click Add to Cursor.
- If you use another tool like Windsurf, you’ll add some JSON to your MCP file. The example below is for Cursor; the exact JSON for your tool might change but, no matter which tool you use, you’ll need to add our MCP
url
. - If your application requires you to set the
type
, make sure you set it tohttp
. We don’t support the server-sent events (sse
) transport.
{ "mcpServers": { "CustomerIO": { "type": "http", "url": "https://mcp.customer.io/mcp" } } }
When you’ve added MCP support, your IDE will show that you need to login or authenticate with Customer.io. In Cursor, you’ll click Needs Login to authenticate with Customer.io.
Pick the workspaces you want to use with the MCP server.
Claude Desktop and similar tools
The instructions below focus on Claude Desktop, but the exact path to add Customer.io MCP support depends on the tool you use, but you’ll need to add the URL of our server to any tool you use: https://mcp.customer.io/mcp
or https://mcp-eu.customer.io/mcp
if your Customer.io account is in the EU.
Note that MCP support is not available on Claude’s free plan. You need a paid Claude plan to use custom MCP servers like Customer.io’s.
Go to > Personal Settings.
Click the Claude Desktop tab and enable support for your tool.
- For Claude Desktop, go to Settings > Connectors and click Add custom connector.
- Add the MCP server URL:
https://mcp.customer.io/mcp
orhttps://mcp-eu.customer.io/mcp
if your Customer.io account is in the EU. If your application requires you to set atype
or transport method, make sure you set it tohttp
. We don’t support the server-sent events (sse
) transport. - Click Connect.
Pick the workspaces you want to use with the MCP server.
Find your workspace
When you use our MCP server, you’ll often need to tell it which workspace you want to work in. Otherwise, the MCP server may ask you to select a workspace. You can select your workspace by name or by ID. You can even use the MCP server to list your available workspaces.
You’ll find the name of your workspace in the upper-left corner of our interface. You’ll find the ID of your workspace in the URL when you’re on the Dashboard page.


See MCP sessions
We log MCP sessions so you can control and revoke your own MCP sessions.
- Go to > Personal Settings.
- Under Connected clients, click View sessions.
From here you can see active sessions for a client. Click Revoke to end a session and require the client to re-authenticate with Customer.io

