How to connect Customerio to Grok Bot

Connect Grok Bot to Customerio MCP. List all segments in your workspace, get delivery metrics for last week's emails, and more using natural language, with authentication handled for you.

Customerio logoCustomerio
Api Key

Customer.io is a customer engagement platform for targeted messaging across email, SMS, and push. Easily automate, segment, and track communications with your audience.

39 Tools

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.

Also integrate Customerio with

Why use Composio?

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.

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 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

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

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.

Composio authorization screen with Authorize and Deny

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.

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.

TOOLS

Supported Tools

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

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.

Author, Version, and Publish Email

Update and version a linked Design Studio email, then publish it.

Create Profile Alias

Create an alias to merge Customer.io profiles for a person with multiple identifiers.

Create Segment

Create an empty manual segment in Customer.io.

Suppress Customer Profile

Suppress a customer profile to permanently delete it and prevent re-adding with the same identifier.

Find Customers by Email

Return Customer.io profiles whose email exactly matches the provided address.

Get Account Region

Return the region and Track API URL for the connected Customer.io account.

Get Customer Attributes

Return one Customer.io profile's attributes and devices.

Get Integrations

Retrieve a list of integrations in your workspace to discover configured integrations.

Get Messages

Tool to retrieve a list of messages sent from your workspace.

Get Newsletter Content Metrics

Retrieve engagement metrics for a Customer.io one-time send variant.

Get Newsletter Metrics

Retrieve aggregate engagement metrics for a Customer.io one-time send.

Get Segment Customer Count

Return the current number of profiles in a Customer.io segment.

Get Segment Details

Tool to retrieve details of a specific segment.

Get Segment Membership

Tool to retrieve people in a specific segment.

Get Segments

Tool to retrieve a list of segments in your workspace.

Get Transactional Metrics

Return aggregate engagement metrics for a transactional message template.

Get Trigger

Retrieves details about a specific API-triggered broadcast, including trigger ID, campaign ID, creation timestamp, recipient filter criteria, and personalization data.

Get Broadcast Triggers

Retrieve all API trigger instances for a specific broadcast/campaign.

Get Customer.io Workspace Webhooks

Retrieves all reporting webhook configurations from the Customer.io workspace.

Identify Person

Identify a person in Customer.io and assign traits, creating a profile or updating an existing one.

List Activities

Return recent workspace activity-log entries with optional filters.

List Campaigns

Return Customer.io automations and their metadata.

List Collections

Tool to list all Collections metadata.

List Customer Attributes

Return attributes and devices for up to 100 Customer.io profiles.

List IP Addresses

Tool to retrieve the list of IP addresses used by Customer.io for sending messages.

List Newsletters

Tool to list all newsletters.

List Snippets

Tool to list all snippets in your workspace.

List Transactional Contents

Return every language and content variant of a transactional template.

List Transactional Messages

Lists all transactional message templates in your Customer.io workspace.

List Workspaces

List Customer.io workspaces and their cached usage counts.

Preview Email

Evaluate a Design Studio email against sample Liquid data without sending.

Search Customers

Search Customer.io profiles using an audience filter.

Send Batch CDP Calls

Send multiple CDP calls (identify, track, page, screen, group, alias) in a single batch request.

Track Event

Tool to send an event associated with a person in Customer.io.

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.

Track Screen View

Track mobile screen views in Customer.io for analytics and user journey tracking.

Trigger Broadcast

Manually trigger a Customer.io broadcast/campaign to send messages to a defined audience.

Unsubscribe from Delivery

Tool to handle custom unsubscribe requests for email deliveries in Customer.io.

FAQ

Frequently asked questions

Start with Customerio.It takes 30 seconds.

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

Start building