How to integrate Spondyr MCP with Codex

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

Spondyr logoSpondyr
Api Key

Spondyr is a dynamic email templating and automation platform. It helps you send personalized, high-impact emails at scale with ease.

21 Tools

Introduction

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

Also integrate Spondyr 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 Spondyr 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 Spondyr MCP server, and what's possible with it?

The Spondyr MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Spondyr account. It provides structured and secure access to your Spondyr templates, transaction types, events, and correspondence workflows, so your agent can perform actions like managing conditions, handling recipients, orchestrating correspondence delivery, and monitoring status updates for your business communications.

  • Comprehensive transaction type management: Quickly create, list, or update transaction types—making it easy for your agent to adapt Spondyr to your evolving business data needs.
  • Rule-based template selection: Define and manage conditions that control which templates are used for different transaction scenarios, ensuring your communications are always personalized and relevant.
  • Automated correspondence delivery and tracking: Have your agent trigger the delivery of generated correspondence and fetch real-time status updates, so you always know when and how your messages are sent.
  • Dynamic event and recipient handling: List, retrieve, update, or delete event types and recipient information to keep your communication flows flexible and up-to-date.
  • Seamless integration and configuration management: Effortlessly connect, configure, and synchronize your Spondyr settings and workflows—without manual intervention or custom code.

Conclusion

You've successfully integrated Spondyr with Codex using Composio's MCP server. Now you can interact with Spondyr 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 Spondyr 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 Spondyr operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

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

List Conditions

Tool to list all conditions for a transaction type.

Create Condition

Create a condition rule for template selection in Spondyr.

Create Transaction Type

Tool to create a new transaction type.

Deliver Spondyr correspondence

Trigger delivery of previously generated correspondence to recipients.

Update Event Type

Tool to update an existing event type name within a transaction type.

List Event Types for Transaction Type

Retrieves all event types associated with a specific transaction type in Spondyr.

Get Spondyr Status

Tool to retrieve the status of a previously generated correspondence.

Get Transaction Types

Tool to retrieve a list of available transaction types.

Delete Recipient

Deletes a recipient configuration from a transaction type in Spondyr.

Get Recipient

Tool to retrieve details of a specific recipient.

List Recipients

Tool to list all recipients for a transaction type.

Create Search Filter

Create a new search filter for a transaction type in Spondyr.

Delete Search Filter

Deletes a specific search filter from the Spondyr system.

Get Search Filter

Retrieves details of a specific search filter in Spondyr by name and transaction type.

List Search Filters

Tool to list all search filters for a transaction type.

Search Correspondence

Search for generated correspondence (spondyrs) by multiple criteria including batch ID, event type, and custom search filters.

Create Spondyr SSO stub

Tool to create a one-time SSO user stub in Spondyr.

Get Template

Retrieve detailed configuration for a specific correspondence template.

List Templates

List all templates configured for a transaction type.

Get Transaction Type

Tool to retrieve details of a specific transaction type.

Update Transaction Type

Updates an existing transaction type's name and/or JSON schema in Spondyr.

FAQ

Frequently asked questions

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

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

Start with Spondyr.It takes 30 seconds.

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

Start building