Customerio with CLI

Customerio CLI for AI Agents

Introduction Also integrate Customerio with What is Universal CLI and why use it?Prerequisites Connecting Customerio to Coding Agents Supported Tools & Triggers Universal CLI Commands for Customerio Generate Type Definitions Tips & Tricks Next Steps How to build Customerio MCP Agent with another framework Explore Other Toolkits FAQ

Connect Customerio without Auth hassles

We manage OAuth, API Key, token refresh, and scopes, you just build.

Try for Free

Introduction

CLIs are eating MCPs. The industry is converging on the very same idea. MCPs for all their merit can be token hungry, slow, and unreliable for complex tool chaining. However, coding agents have become incredibly good at working with CLIs, and in fact they are far more comfortable working with CLI tools than MCP.

With Composio's Universal CLI, your coding agents can talk to over 1000+ SaaS applications. With Customerio, agents can list all segments in your workspace, get delivery metrics for last week's emails, show all people in vip customer segment, and more — all without worrying about authentication.

This guide walks you through Composio Universal CLI and explains how you can connect it with coding agents like Claude Code, Codex, OpenCode, etc, for end-to-end Customerio automation.

Also integrate Customerio with

OpenAI Agents SDK Claude Agent SDK Claude Code Codex OpenClaw Hermes Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI

What is Universal CLI and why use it?

The idea behind building the universal CLI is to give agents a single command interface to interact with all your external applications. Here's what you'll get with it:

Agent-friendly: Coding agents like Claude Code, Codex, and OpenCode can use CLI tools natively — no MCP setup required.
Authentication handled: Connect once via OAuth or API Key, and all CLI commands work with your credentials automatically.
Tool discovery: Search, inspect, and execute 20,000+ tools across 1000+ apps from one interface.
Trigger support: Use triggers to listen for events across your apps, powered by real-time webhooks or polling under the hood.
Type generation: Generate typed schemas for autocomplete and type safety in your projects.

Prerequisites

Install the Composio CLI, authenticate, and initialize your project:

bash

# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Authenticate with Composio
composio login

During login you'll be redirected to sign in page, finish the complete flow and you're all set.

Connecting Customerio to Coding Agents via Universal CLI

Once it is installed, it's essentially done. Claude Code, Codex, OpenCode, OpenClaw, or any other agent will be able to access the CLI. A few steps to give agents access to your apps.

Launch your Coding Agent — Claude Code, Codex, OpenCode, anything you prefer.
Prompt it to "Authenticate with Customerio"
Complete the authentication and authorization flow and your Customerio integration is all set.
Start asking anything you want.

Supported Tools & Triggers

Tools

Suppress Customer ProfileTool to suppress a person.

Get IntegrationsTool to retrieve a list of integrations in your workspace.

Get MessagesTool to retrieve a list of messages sent from your workspace.

Get Segment DetailsTool to retrieve details of a specific segment.

Get Segment MembershipTool to retrieve people in a specific segment.

Get SegmentsTool to retrieve a list of segments in your workspace.

Get TriggerTool to retrieve details about a specific trigger.

Get TriggersTool to retrieve a list of triggers for a specific broadcast.

Get Customer.io Workspace WebhooksTool to retrieve a list of webhooks.

List CollectionsTool to list all collections metadata.

List NewslettersTool to list all newsletters.

List SnippetsTool to list all snippets in your workspace.

List Transactional MessagesTool to list all transactional message templates.

Trigger BroadcastTool to manually trigger a broadcast.

Universal CLI Commands for Customerio

You can also manually execute CLI commands to interact with your Customerio.

Connect your Customerio account

Link your Customerio account and verify the connection:

bash

# Connect your Customerio account (opens OAuth flow)
composio connected-accounts link customerio

# Verify the connection
composio connected-accounts list --toolkits customerio

Discover Customerio tools

Search and inspect available Customerio tools:

bash

# List all available Customerio tools
composio tools list --toolkit customerio

# Search for Customerio tools by action
composio tools search "customerio"

# Inspect a tool's input schema
composio tools info CUSTOMERIO_CUSTOMER_IO_SUPPRESS_PERSON

Common Customerio Actions

Suppress Customer Profile — Tool to suppress a person

bash

composio tools execute CUSTOMERIO_CUSTOMER_IO_SUPPRESS_PERSON \
  --identifier "42"

Get Integrations — Tool to retrieve a list of integrations in your workspace

bash

composio tools execute CUSTOMERIO_GET_INTEGRATIONS

Get Messages — Tool to retrieve a list of messages sent from your workspace

bash

composio tools execute CUSTOMERIO_GET_MESSAGES \
  --type "email" \
  --limit "100" \
  --start "eyJ..." \
  --drafts "<boolean>"

Get Segment Details — Tool to retrieve details of a specific segment

bash

composio tools execute CUSTOMERIO_GET_SEGMENT_DETAILS \
  --segment_id "123"

Generate Type Definitions

Generate typed schemas for Customerio tools to get autocomplete and type safety in your project:

bash

# Auto-detect language
composio generate --toolkits customerio

# TypeScript
composio ts generate --toolkits customerio

# Python
composio py generate --toolkits customerio

Tips & Tricks

Always inspect a tool's input schema before executing: composio tools info <TOOL_NAME>
Pipe output with jq for better readability: composio tools execute TOOL_NAME -d '{}' | jq
Set COMPOSIO_API_KEY as an environment variable for CI/CD pipelines
Use composio dev logs tools to inspect execution logs and debug issues

Next Steps

Try asking your coding agent to perform various Customerio operations
Explore cross-app workflows by connecting more toolkits
Set up triggers for real-time automation
Use composio generate for typed schemas in your projects

How to build Customerio MCP Agent with another framework

OpenAI Agents SDK

Use Customerio MCP with OpenAI Agents SDK

Claude Agent SDK

Use Customerio MCP with Claude Agent SDK

Claude Code

Use Customerio MCP with Claude Code

Codex

Use Customerio MCP with Codex

OpenClaw

Use Customerio MCP with OpenClaw

Hermes

Use Customerio MCP with Hermes

Google ADK

Use Customerio MCP with Google ADK

LangChain

Use Customerio MCP with LangChain

Vercel AI SDK

Use Customerio MCP with Vercel AI SDK

Mastra AI

Use Customerio MCP with Mastra AI

LlamaIndex

Use Customerio MCP with LlamaIndex

CrewAI

Use Customerio MCP with CrewAI

Explore Other Toolkits

Active campaign

API Key

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

Api Key

ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.

Ahrefs

API Key

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.

TOOLKIT MARKETPLACE

FAQ

What is the Composio Universal CLI?

The Composio Universal CLI is a single command-line interface that lets coding agents and developers interact with 1000+ SaaS applications. It handles authentication, tool discovery, action execution, and trigger setup — all from the terminal, without needing to configure MCP servers.

Which coding agents work with the Composio CLI?

Any coding agent that can run shell commands works with the Composio CLI — including Claude Code, Codex, OpenCode, OpenClaw, and others. Once the CLI is installed, agents automatically discover and use the composio commands to interact with Customerio and other connected apps.

How is the CLI different from using an MCP server for Customerio?

MCP servers require configuration and can be token-heavy for complex workflows. The CLI gives agents a direct, lightweight interface — no server setup needed. Agents simply call composio commands like any other shell tool. It's faster to set up, more reliable for multi-step tool chaining, and works natively with how coding agents already operate.

How safe is my Customerio data when using the Composio CLI?

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. You can also bring your own OAuth credentials for full control.

Used by agents from

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free

Harsha GaddipatiCo-founder, Slashy

Karan skipped his own birthday party to fix our critical issue. It was 10 pm and he diverted his Waymo to help us instead. This really sets the bar, shows you the commitment you need to have when users rely on your software.

Abhi AryaCo-founder, Opennote

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it has immensely helped in keeping new users on the platform.

Nirman DaveCEO, Zams

We chose Composio over Pipedream because it delivered depth where it mattered. It supported niche tools and tricky edge cases that other platforms simply ignored. Giving us confidence to scale without compromising.

Ryan YuFounder, Extra Thursday

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down in the complexities of managing agent auth would have been a death sentence for Extra Thursday.

Tomisin JenrolaFounder & CEO, SwarmZero

Before partnering with Composio, adding tool integrations was a slow, resource-intensive process. Each integration could take weeks or months of engineering time, and maintaining them meant constantly keeping up with API changes.

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Customerio CLI for AI Agents

Table of Contents

Connect Customerio without Auth hassles

Introduction

Also integrate Customerio with

What is Universal CLI and why use it?

Prerequisites

Connecting Customerio to Coding Agents via Universal CLI

Supported Tools & Triggers

Universal CLI Commands for Customerio

Connect your Customerio account

Discover Customerio tools

Common Customerio Actions

Suppress Customer Profile — Tool to suppress a person

Get Integrations — Tool to retrieve a list of integrations in your workspace

Get Messages — Tool to retrieve a list of messages sent from your workspace

Get Segment Details — Tool to retrieve details of a specific segment

Generate Type Definitions

Tips & Tricks

Next Steps

How to build Customerio MCP Agent with another framework

OpenAI Agents SDK

Claude Agent SDK

Claude Code

Codex

OpenClaw

Hermes

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Explore Other Toolkits

Active campaign

ActiveTrail

Ahrefs

FAQ

What is the Composio Universal CLI?

Which coding agents work with the Composio CLI?

How is the CLI different from using an MCP server for Customerio?

How safe is my Customerio data when using the Composio CLI?

Used by agents from

Never worry about agent reliability