How to integrate Modem MCP with Codex

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Modem MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Modem logoModem
Api Key

Modem is a customer intelligence platform that turns conversations into structured topics, people, and company insights. Use it to analyze feedback patterns and automate customer workflows faster.

30 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Modem MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Modem 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 1000+ 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 Modem 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_*******" }

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

The Modem MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Modem account. It provides structured and secure access to your customer conversation topics, people, companies, channels, and activity insights, so your agent can search topics, analyze engagement, manage customer records, review histories, and organize insights on your behalf.

  • Topic discovery and analysis: Have your agent search customer conversation topics by keywords or meaning, then review summaries, classifications, priorities, participants, message groups, and history.
  • People and company insights: Let the agent find people and companies, inspect their profiles and conversation activity, and see how engagement breaks down across sources.
  • Customer record management: Direct your agent to create or update people and companies, associate people with companies, and connect external records to the right profiles.
  • Channel and activity monitoring: Instruct your agent to review connected conversation channels, message counts, company activity trends, and source-level engagement.
  • Data cleanup and topic organization: Have your agent update topic priorities or archive states, inspect change histories, and merge duplicate topics, people, or companies when needed.

Conclusion

You've successfully integrated Modem with Codex using Composio's MCP server. Now you can interact with Modem 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 Modem operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

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

Supported Tools

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

Add People to Company

Associate one or more existing people with an existing company.

Create Companies

Create one to 50 companies in one batch.

Create People

Create one to 50 people in one batch.

Get Channel

Get one channel's source details, connection state, context, timestamps, and message count by UUID.

Get Company

Get one company's core details, connection values, domain, logo, and VIP status by decimal ID.

Get Company Activity

Get one company's message count, weekly activity series, and source-level message breakdown.

Get Company History

Get up to 50 company audit records plus merge history.

Get Company Identities

Get external platform identities linked to one company by Modem's identify operation.

Get Current Organization

Return the organization selected by the connected API key.

Get Person

Get one person's complete profile, including company, connections, tags, sources, timestamps, identities, and message activity aggregates.

Get Person History

Get up to 50 person audit records plus merge history.

Get Person Identities

Get all external platform identities linked to one person.

Get Person Source Stats

Get one person's message counts broken down by source platform.

Get Topic

Get one topic's complete details, including its summary, classification, lifecycle, priority, keywords, time range, archive state, and event count.

Get Topic Groups

Get every message group assigned to one topic in ascending or descending group-time order.

Get Topic History

Get up to 50 topic audit records plus action and merge history.

Get Topic People

Get every unique person who participated in one topic, including source identities, company, profile, VIP state, and contribution count.

Identify External Records

Upsert links from external platform records to Modem people and companies in batches of 50.

List Channels

List organization channels with connection state and message counts, optionally filtered by source, name, or channel IDs.

List Companies

List companies with person and message aggregates, optionally searching and sorting the result.

List Groups

List message groups for exactly one company or one person, returning compact message content and topic context one page at a time.

List People

List people with aggregated message statistics, optionally filtering by search text, ecosystem tags, or company and sorting the result.

List and Search Topics

List or search topics by keywords or semantic meaning with organization, participant, source, status, date, and classification filters, one page at a time.

Merge Companies Irreversibly

Irreversibly merge one or more source companies into one surviving target.

Merge People Irreversibly

Irreversibly merge one or more source people into one surviving target.

Merge Topics Irreversibly

Irreversibly merge 1 to 50 source topics into one surviving target.

Update Companies

Update one to 50 companies in one batch.

Update People

Update one to 50 people in one batch.

Update Topic

Update one topic's priority, lifecycle, issue type, complete keyword list, or archive state.

Update Topics

Set priority or archive state for one to 100 topics at once.

FAQ

Frequently asked questions

With a standalone Modem MCP server, the agents and LLMs can only access a fixed set of Modem tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Modem 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 Modem tools.

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

Start with Modem.It takes 30 seconds.

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

Start building