Iterable MCP Server

Note: This is an unofficial, community-built MCP server. While Iterable has an official MCP server, our team ran into several issues with it, so we built this one tailored to our specific use cases.

A Model Context Protocol (MCP) server for the Iterable API. It lets AI assistants (Claude, Cursor, Devin, etc.) access your Iterable data — campaign analytics, subscriber lists, user profiles, templates, and more — through a standardized interface.

Quick Start

Prerequisites

• Node.js 18+
• An Iterable API key (how to create one)

Running via npx

No installation required:

ITERABLE_API_KEY=your-api-key npx iterable-mcp

Configuration with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "iterable": {
      "command": "npx",
      "args": ["-y", "iterable-mcp"],
      "env": {
        "ITERABLE_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration with Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "iterable": {
      "command": "npx",
      "args": ["-y", "iterable-mcp"],
      "env": {
        "ITERABLE_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration with VS Code (GitHub Copilot)

Add to your .vscode/mcp.json:

{
  "servers": {
    "iterable": {
      "command": "npx",
      "args": ["-y", "iterable-mcp"],
      "env": {
        "ITERABLE_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration with Devin

In Devin's MCP settings, add a new server:

• Name: iterable
• Command: npx -y iterable-mcp
• Environment Variables:
  • ITERABLE_API_KEY → your API key

Environment Variables

Variable	Required	Description
ITERABLE_API_KEY	Yes	Your Iterable server-side API key

Available Tools

Campaigns

Tool	Description
list_campaigns	List campaigns with pagination, sorting, and state filtering
get_campaign	Get detailed metadata for a specific campaign
get_campaign_metrics	Get performance metrics (opens, clicks, bounces, etc.) for one or more campaigns

Subscriber Lists

Tool	Description
get_lists	List all subscriber lists
get_list_size	Get subscriber count for a specific list
get_list_users	Get email addresses subscribed to a list

Users

Tool	Description
get_user_by_email	Look up a user profile by email address

Data Export

Tool	Description
export_data	Export user data, subscribe events, or bounce events as CSV (parsed to JSON)

Templates

Tool	Description
get_templates	List email templates with filtering by type
get_template	Get a specific email template by ID

Configuration

Tool	Description
get_message_types	List all message types
get_channels	List all messaging channels
get_metadata_tables	List all metadata tables
get_metadata_table	Get all keys in a specific metadata table

Usage Tips

Campaign Metrics

The get_campaign_metrics tool returns rich CSV data parsed into JSON. Key metrics include:

• Total Email Sends — emails sent
• Unique Email Opens (filtered) — bot-filtered unique opens (best for open rate)
• Unique Email Clicks (filtered) — bot-filtered unique clicks (best for CTR)
• Total Unsubscribes — unsubscribe count
• Total Emails Bounced — bounce count
• Total Complaints — spam complaints

You can pass multiple campaign IDs in a single request to get metrics for an entire week of campaigns at once.

Rate Limits

• The export API (export_data) has aggressive rate limiting — space requests 10-15 seconds apart.
• Campaign metrics are less aggressive but still space requests 2-3 seconds apart when fetching in bulk.

Open Rate & CTR Formulas

• Open Rate = Unique Email Opens (filtered) / Total Email Sends
• Click-Through Rate = Unique Email Clicks (filtered) / Total Email Sends

Development

git clone https://github.com/jginorio/iterable-mcp.git
cd iterable-mcp
npm install
npm run build

To test locally:

ITERABLE_API_KEY=your-key node dist/index.js

License

MIT