# How to connect Customerio to Grok Bot

```json
{
  "title": "How to connect Customerio to Grok Bot",
  "toolkit": "Customerio",
  "toolkit_slug": "customerio",
  "framework": "Grok Bot",
  "framework_slug": "grok-bot",
  "url": "https://composio.dev/toolkits/customerio/framework/grok-bot",
  "markdown_url": "https://composio.dev/toolkits/customerio/framework/grok-bot.md",
  "updated_at": "2026-11-12T07:05:39.539Z"
}
```

## Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.
This guide explains how to connect Customerio to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Customerio in plain language.
For exact tool slugs and parameter tables, see the [tool catalog in the Composio docs](https://docs.composio.dev/toolkits/customerio).

## Also integrate Customerio with

- [Claude Code](https://composio.dev/toolkits/customerio/framework/claude-code)
- [ChatGPT](https://composio.dev/toolkits/customerio/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/customerio/framework/claude-cowork)
- [Antigravity](https://composio.dev/toolkits/customerio/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/customerio/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/customerio/framework/claude-agents-sdk)
- [Codex](https://composio.dev/toolkits/customerio/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/customerio/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/customerio/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/customerio/framework/atomic-agent)
- [Google ADK](https://composio.dev/toolkits/customerio/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/customerio/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/customerio/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/customerio/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/customerio/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/customerio/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/customerio/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/customerio/framework/autogen)

## TL;DR

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:
- Connect to 1,700+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
- Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
- Handle large tool responses outside the model context to keep conversations lean.

## Connect Customerio to Grok Bot

### Connecting Customerio to Grok Bot
Once Grok Bot is set up, you connect Customerio entirely from its interface, and the whole flow takes under a minute.
### Set up Grok Bot
Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from [x.ai/bot](https://x.ai/bot) and sign in. An iPhone companion app is also available, and your bots sync across devices.
Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.
### Connect Customerio
### 1. Add the Composio plugin
Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.
[Add to Grok Bot](https://x.ai/bot/plugin/32661537)
Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.
### 2. Authenticate
Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.
Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.
### 3. Connect your Customerio account
Back in the chat, ask your bot to connect to Customerio or give it any Customerio task.
For example, ask it to:
- "List all segments in your workspace"
- "Get delivery metrics for last week's emails"
- "Show all people in VIP customer segment"
It will prompt you to authenticate and authorize access.
That's it. Composio's tools are now available in your Grok bot, and your Customerio account is ready to use.

## What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.
With Composio Connect, your Grok bot can securely access apps like Customerio through MCP without you sharing account credentials directly with the agent.

## What is the Customerio MCP server, and what's possible with it?

The Customerio MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Customer.io account. It provides structured and secure access to your customer engagement workspace, allowing your agent to send targeted communications, manage segments, retrieve messaging analytics, and automate customer data management on your behalf.
- Targeted message analytics and tracking: Retrieve detailed lists of messages sent, including delivery metrics, to monitor campaign performance and engagement.
- Segment discovery and membership management: Let your agent fetch all segments, get details for a specific segment, and list all customers in a segment for precise audience targeting.
- Integration and webhook management: Have your agent list and review all integrations and webhooks in your workspace to streamline system connectivity and reporting.
- Customer profile suppression: Direct your agent to permanently suppress (delete and block) customer profiles, ensuring compliance and data privacy.
- Collection metadata retrieval: Retrieve up-to-date details for all collections in your workspace, keeping your AI-powered workflows and automations in sync with your data sources.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `CUSTOMERIO_ADD_PERSON_TO_GROUP` | Add Person to Group | Add a person to a Customer.io group to establish a relationship with an object such as a company, account, or project. Supply the person and group IDs and optionally provide group traits. |
| `CUSTOMERIO_AUTHOR_VERSION_AND_PUBLISH_EMAIL` | Author, Version, and Publish Email | Update and version a linked Design Studio email, then publish it. Publishing makes the content live in the linked workflow for every language variant. The email must be linked to a workflow. Multi-language publishes can return pending with a publish_id; check publish status separately until Customer.io reports completion. The update and saved version persist if the publish step fails. |
| `CUSTOMERIO_CREATE_ALIAS` | Create Profile Alias | Create an alias to merge Customer.io profiles for a person with multiple identifiers. The previous ID identifies the source profile and the user ID identifies the destination profile. |
| `CUSTOMERIO_CREATE_SEGMENT` | Create Segment | Create an empty manual segment in Customer.io. |
| `CUSTOMERIO_CUSTOMER_IO_SUPPRESS_PERSON` | Suppress Customer Profile | Suppress a customer profile to permanently delete it and prevent re-adding with the same identifier. IMPORTANT: This action requires Track API credentials (Basic Auth with siteId:apiKey), not App API credentials. Suppression also deletes the customer profile - you don't need to call a separate delete endpoint. Use this for GDPR/CCPA compliance requests. The operation is irreversible and prevents any future attempts to re-add a person with the same identifier (email or ID). |
| `CUSTOMERIO_FIND_CUSTOMERS_BY_EMAIL` | Find Customers by Email | Return Customer.io profiles whose email exactly matches the provided address. |
| `CUSTOMERIO_GET_ACCOUNT_REGION` | Get Account Region | Return the region and Track API URL for the connected Customer.io account. |
| `CUSTOMERIO_GET_CUSTOMER_ATTRIBUTES` | Get Customer Attributes | Return one Customer.io profile's attributes and devices. |
| `CUSTOMERIO_GET_INTEGRATIONS` | Get Integrations | Retrieve a list of integrations in your workspace to discover configured integrations. An HTTP 404 response is returned as an empty list. |
| `CUSTOMERIO_GET_MESSAGES` | Get Messages | Tool to retrieve a list of messages sent from your workspace. Use when you need paginated delivery metrics for messages, e.g., list email messages delivered between two timestamps. |
| `CUSTOMERIO_GET_NEWSLETTER_CONTENT_METRICS` | Get Newsletter Content Metrics | Retrieve engagement metrics for a Customer.io one-time send variant. |
| `CUSTOMERIO_GET_NEWSLETTER_METRICS` | Get Newsletter Metrics | Retrieve aggregate engagement metrics for a Customer.io one-time send. |
| `CUSTOMERIO_GET_SEGMENT_CUSTOMER_COUNT` | Get Segment Customer Count | Return the current number of profiles in a Customer.io segment. |
| `CUSTOMERIO_GET_SEGMENT_DETAILS` | Get Segment Details | Tool to retrieve details of a specific segment. Use after identifying the segment ID from list segments. |
| `CUSTOMERIO_GET_SEGMENT_MEMBERSHIP` | Get Segment Membership | Tool to retrieve people in a specific segment. Use when you need to page through segment membership after identifying segment ID. |
| `CUSTOMERIO_GET_SEGMENTS` | Get Segments | Tool to retrieve a list of segments in your workspace. Use when you need to fetch all segments after configuring segment rules. |
| `CUSTOMERIO_GET_TRANSACTIONAL_METRICS` | Get Transactional Metrics | Return aggregate engagement metrics for a transactional message template. |
| `CUSTOMERIO_GET_TRIGGER` | Get Trigger | Retrieves details about a specific API-triggered broadcast, including trigger ID, campaign ID, creation timestamp, recipient filter criteria, and personalization data. Use this after triggering a broadcast to verify its configuration and check the data used for message personalization. |
| `CUSTOMERIO_GET_TRIGGERS` | Get Broadcast Triggers | Retrieve all API trigger instances for a specific broadcast/campaign. Returns trigger metadata including IDs, creation timestamps, and processing status. Use after triggering a broadcast to list all its trigger executions. |
| `CUSTOMERIO_GET_WEBHOOKS` | Get Customer.io Workspace Webhooks | Retrieves all reporting webhook configurations from the Customer.io workspace. Reporting webhooks send event notifications (message sent, opened, clicked, etc.) to your specified endpoints. Use this to list all configured webhooks and their settings including subscribed events, endpoints, and status. Returns an empty list if no webhooks are configured. |
| `CUSTOMERIO_IDENTIFY_PERSON` | Identify Person | Identify a person in Customer.io and assign traits, creating a profile or updating an existing one. Provide a user ID or anonymous ID to identify the person, and optionally specify when the identification occurred. |
| `CUSTOMERIO_LIST_ACTIVITIES` | List Activities | Return recent workspace activity-log entries with optional filters. |
| `CUSTOMERIO_LIST_CAMPAIGNS` | List Campaigns | Return Customer.io automations and their metadata. |
| `CUSTOMERIO_LIST_COLLECTIONS` | List Collections | Tool to list all Collections metadata. Use when you need to retrieve current details of each Collection in your workspace. |
| `CUSTOMERIO_LIST_CUSTOMER_ATTRIBUTES` | List Customer Attributes | Return attributes and devices for up to 100 Customer.io profiles. |
| `CUSTOMERIO_LIST_IP_ADDRESSES` | List IP Addresses | Tool to retrieve the list of IP addresses used by Customer.io for sending messages. Use when you need to allowlist or configure firewall rules for Customer.io's sending infrastructure. |
| `CUSTOMERIO_LIST_NEWSLETTERS` | List Newsletters | Tool to list all newsletters. Use when paginating through newsletter metadata. |
| `CUSTOMERIO_LIST_SNIPPETS` | List Snippets | Tool to list all snippets in your workspace. Use when you need to retrieve all reusable content snippets for templating or dynamic content insertion. |
| `CUSTOMERIO_LIST_TRANSACTIONAL_CONTENTS` | List Transactional Contents | Return every language and content variant of a transactional template. |
| `CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES` | List Transactional Messages | Lists all transactional message templates in your Customer.io workspace. Returns the ID and name (trigger name) for each template. Use this when you need to discover available transactional message templates or retrieve their IDs for sending messages via the API. |
| `CUSTOMERIO_LIST_WORKSPACES` | List Workspaces | List Customer.io workspaces and their cached usage counts. |
| `CUSTOMERIO_PREVIEW_EMAIL` | Preview Email | Evaluate a Design Studio email against sample Liquid data without sending. |
| `CUSTOMERIO_SEARCH_CUSTOMERS` | Search Customers | Search Customer.io profiles using an audience filter. |
| `CUSTOMERIO_SEND_BATCH` | Send Batch CDP Calls | Send multiple CDP calls (identify, track, page, screen, group, alias) in a single batch request. Use this to efficiently send multiple events or profile updates in one API call. The batch endpoint supports up to 500KB total with 32KB per individual call. Each call in the batch can be a different type (identify, track, page, screen, group, or alias). Requirements by call type: - identify/track/page/screen: Require userId or anonymousId - group: Requires groupId (and userId or anonymousId) - track: Requires event name - alias: Requires userId and previousId Note: This action uses the CDP API base URL (https://cdp.customer.io/v1) which differs from the Track API base URL used by some other Customer.io actions. |
| `CUSTOMERIO_TRACK_EVENT` | Track Event | Tool to send an event associated with a person in Customer.io. Records actions users take, along with properties that describe the action. Use when you need to track user behavior, conversions, or custom events for segmentation and campaigns. |
| `CUSTOMERIO_TRACK_PAGE` | Track Page View | Track page views for website visitors through the Customer.io CDP API, providing a user ID or anonymous ID and optional page properties. The Pipelines API uses basic authorization; this action forwards the connection's authorization headers. |
| `CUSTOMERIO_TRACK_SCREEN` | Track Screen View | Track mobile screen views in Customer.io for analytics and user journey tracking. Records when a user views a screen in your mobile app. Use this when you need to: - Track user navigation patterns in mobile apps - Record screen views for engagement analytics - Trigger workflows based on specific screen visits - Build user journey maps based on screen flow Requirements: - Provide either userId (for known users) or anonymousId (for anonymous users) - Screen name is required to identify which screen was viewed - Optionally include properties for additional context (platform, category, etc.) Note: This endpoint uses the CDP API (cdp.customer.io), not the standard App API. |
| `CUSTOMERIO_TRIGGER_BROADCAST` | Trigger Broadcast | Manually trigger a Customer.io broadcast/campaign to send messages to a defined audience. Use this when you need to: - Send a pre-configured broadcast to specific recipients (by ID or email) - Override the broadcast's default UI-defined audience with custom filtering - Provide personalization data for Liquid template variables - Send individualized content using per_user_data Requirements: - broadcast_id: Must be a valid broadcast ID from Customer.io (find in broadcast's Triggering Details) - Audience: Provide exactly ONE of: recipients, ids, emails, per_user_data, or data_file_url Rate Limits: This endpoint allows one request every 10 seconds per broadcast. |
| `CUSTOMERIO_UNSUBSCRIBE_DELIVERY` | Unsubscribe from Delivery | Tool to handle custom unsubscribe requests for email deliveries in Customer.io. Use when you need to unsubscribe a person from emails and attribute the action to a specific delivery. IMPORTANT: This action requires Track API credentials (Basic Auth with siteId:apiKey), not App API credentials. The unsubscribe action sets the person's unsubscribed attribute to true. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

Once connected, your Grok bot can access the Customerio MCP server through Composio to run the actions you authorize, using plain language in the chat.

## Complete Code

None listed.

## Conclusion

### Way Forward
Now that Customerio is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.
- Connect Calendar to turn threads into scheduled meetings automatically.
- Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
- Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
- Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.
Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

## How to build Customerio MCP Agent with another framework

- [Claude Code](https://composio.dev/toolkits/customerio/framework/claude-code)
- [ChatGPT](https://composio.dev/toolkits/customerio/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/customerio/framework/claude-cowork)
- [Antigravity](https://composio.dev/toolkits/customerio/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/customerio/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/customerio/framework/claude-agents-sdk)
- [Codex](https://composio.dev/toolkits/customerio/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/customerio/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/customerio/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/customerio/framework/atomic-agent)
- [Google ADK](https://composio.dev/toolkits/customerio/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/customerio/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/customerio/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/customerio/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/customerio/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/customerio/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/customerio/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/customerio/framework/autogen)

## Related Toolkits

- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Adobe Marketing Agent MCP](https://composio.dev/toolkits/adobe_marketing_agent_mcp) - Adobe Marketing Agent MCP is Adobe's hosted MCP service that exposes marketing context, preferences, and agent capabilities. Use it to provide agents with campaign, audience, and analytics context via a managed integration.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [AimTell](https://composio.dev/toolkits/aimtell) - AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics. Use it to send targeted browser notifications and measure engagement across your web push campaigns.
- [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.
- [AWeber](https://composio.dev/toolkits/aweber) - AWeber is an email marketing platform for creating campaigns, lists, and landing pages. It helps businesses automate email outreach and measure subscriber engagement.
- [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active.
- [Beehiiv](https://composio.dev/toolkits/beehiiv) - Beehiiv is a newsletter platform for creating and managing publications and subscribers. It helps grow audience engagement and monetize your mailing list.
- [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place.
- [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.
- [Bitly](https://composio.dev/toolkits/bitly) - Bitly is a link management platform for shortening, customizing, sharing, and tracking links and QR codes. It helps teams create branded links and measure engagement across campaigns.
- [BlueFox Email](https://composio.dev/toolkits/bluefox_email) - BlueFox Email is an email API for managing contacts, subscriber lists, and sending transactional and triggered messages. Use it to reliably send transactional and triggered emails and manage subscribers at scale.
- [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere.
- [Braze](https://composio.dev/toolkits/braze) - Braze is a customer engagement platform for managing user data, messaging, campaigns, and analytics. Use it to deliver targeted, multi-channel messaging and analyze campaign performance.
- [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.
- [Buffer](https://composio.dev/toolkits/buffer) - Buffer is a social media management platform for planning, creating, scheduling, and publishing posts across connected channels. It helps teams keep content organized and publish consistently without jumping between social apps.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Customerio MCP?

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

### Can I use Tool Router MCP with Grok Bot?

Yes, you can. Grok Bot 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 Customerio tools.

### Can I manage the permissions and scopes for Customerio while using Tool Router?

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

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
