How to integrate Reply io MCP with Codex

Connect Codex to Reply io MCP. List all active campaigns this week, show contacts added to sales lists, and more using natural language, with authentication handled for you.

Reply io logoReply io
Api Key

Reply.io is an AI-powered sales engagement platform for automating sales outreach across multiple channels. Boosts lead conversion and sales productivity through integrated workflows.

35 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Reply io MCP integration, Codex can create and update contacts, add contacts to sequences, start and pause sequences, track sequence stats, and connect email accounts, all without leaving the terminal or the app, whichever you prefer.

Also integrate Reply io with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Reply io MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Reply io task. The first time, Composio asks you to connect your Reply io account.

For example, ask it to:

  • "List all active campaigns this week"
  • "Show contacts added to sales lists"
  • "Delete a campaign by campaign ID"

What is the Reply io MCP server, and what's possible with it?

The Reply io MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Reply io account. It provides structured and secure access to your sales engagement platform, so your agent can manage campaigns, handle contacts, organize sequences, and automate routine sales operations on your behalf.

  • Campaign and sequence management: Effortlessly list, browse, and delete campaigns or sequences to keep your outreach organized and up to date.
  • Contact and list organization: Let your agent fetch, review, and organize your Reply io contacts and contact lists for targeted sales actions.
  • Email account administration: Retrieve all connected email accounts or remove outdated ones, making sure your sales tools stay streamlined.
  • User and access control: Easily remove users or generate unique identifiers for tasks, maintaining security and clarity in your team’s workflow.
  • Automated data retrieval: Quickly pull up paginated lists of campaigns, sequences, email accounts, or contact lists to inform your sales strategies and next steps.

Conclusion

You've successfully integrated Reply io with Codex using Composio's MCP server. Now you can interact with Reply io directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Reply io operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Reply io operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

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

Add Contact to Sequence

Move an existing contact to a sequence in Reply.

Archive Sequence

Tool to archive a sequence.

Clear Contact Status

Tool to clear statuses from contacts.

Connect Exchange Account via OAuth

Tool to initiate OAuth connection for an Exchange email account.

Connect Gmail Account

Tool to initiate Gmail account connection via OAuth.

Create Contact

Tool to create a new contact in Reply.

Create Sequence Step

Add a step to an existing Reply.

Delete Contact

Delete a contact by ID.

Delete Email Account

Delete an email account by ID.

Delete Schedule

Delete a schedule by ID using the Reply API v2.

Delete Sequence

Tool to delete a sequence.

Delete User

Requests deletion of a user by ID.

Generate ULID

Generate a ULID-like identifier using a millisecond timestamp and a random alphanumeric suffix.

Get Contact Activities

Retrieve one page of tracked activities for a Reply.

Get Contact by ID

Tool to retrieve a contact by ID.

Get Contact Status

Tool to get contact status.

Get Current User

Tool to get the current authenticated user's ID.

Reply.io Get Disconnected Email Accounts

List disconnected email accounts for troubleshooting.

Get Sequence By ID

Tool to retrieve detailed information about a sequence by its ID.

Get Sequence Contacts Extended

Retrieve a page of contacts enrolled in a sequence, with optional additional details such as engagement status, current step and completion timestamps.

Get Sequence Stats

Get aggregate email and LinkedIn engagement statistics for a sequence.

Get Sequence Step by ID

Tool to retrieve details of a specific sequence step.

List Contacts Basic

List contacts to gather contact IDs, with page and page-size controls.

Reply.io List Email Accounts

List Reply.

Reply.io List Lists

List contact lists in the Reply.

List Sequences

Browse Reply.

List Sequence Steps

Tool to retrieve all steps in a sequence.

Pause Sequence

Tool to pause a running sequence.

Remove Contact From Sequence

Tool to remove a contact from a sequence.

Bulk Remove Contacts from Sequence

Tool to bulk remove multiple contacts from a sequence at once.

Search Contacts by Email

Search Reply.

Set Contact Status

Tool to set the status of one or more contacts.

Start Sequence

Tool to start a sequence.

Update Contact

Tool to update an existing contact's information.

Update Email Account

Update an email account's custom SMTP/IMAP configuration, sender name, signature and daily limit.

FAQ

Frequently asked questions

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

Yes, you can. Codex 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 Reply io tools.

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

Start with Reply io.It takes 30 seconds.

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

Start building