Connect Claude Desktop, Cursor, VS Code, and other AI clients to your EmailPilot data using the Model Context Protocol (MCP). Query your campaign calendars, revenue goals, product analytics, and creative guidelines directly from your AI assistant.
Table of Contents
What is MCP?
The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources. Instead of copying and pasting data into your AI chat, MCP allows Claude and other AI clients to directly query your EmailPilot account.
With the EmailPilot MCP server, you can ask your AI assistant to:
Review campaign calendars — “What emails are scheduled for March?”
Check revenue goals — “How are we tracking against our Q1 targets?”
Analyze product performance — “Which products are our top sellers this month?”
Get creative guidelines — “What subject line patterns work best for this brand?”
Review pending approvals — “Are there any campaigns waiting for my approval?”
Quick Start
Get up and running in under 5 minutes:
Generate your MCP token Go to your Organization Dashboard → Billing tab and click “Generate MCP Token”.
Copy the configuration After generating, you’ll see a JSON configuration snippet. Copy it.
Add to Claude Desktop Open ~/.claude/claude_desktop_config.json and paste the configuration.
Restart Claude Desktop Quit and reopen Claude Desktop. You’ll see a hammer icon (🔨) indicating MCP tools are available.
ℹ️ Free Demo Mode: You can try the MCP server without authentication using the demo brand “Faceman’s Coffee”. Just omit the EMAILPILOT_AUTH_TOKEN from the config.
Getting Your MCP Token
Your MCP token is a secure credential that grants your AI client access to your EmailPilot data. Tokens are valid for 90 days.
To generate a token:
Log in to EmailPilot
Navigate to Organization Dashboard → Billing tab
Find the MCP Plugin for Claude card
Click Generate MCP Token
Copy the generated configuration snippet
⚠️ Keep your token secure. Your MCP token provides access to your EmailPilot data. Don’t share it publicly or commit it to version control. If compromised, regenerate it immediately from the Organization Dashboard.
Setting Up Claude Desktop
Claude Desktop is Anthropic’s native application for macOS and Windows. Here’s how to configure it with EmailPilot:
Step 1: Locate Your Config File
The Claude Desktop configuration file is located at:
macOS: ~/.claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
If the file doesn’t exist, create it.
Step 2: Add the EmailPilot Configuration
Add the following to your config file (replace your-token-here with your actual token):
{ "mcpServers": { "emailpilot": { "command": "npx", "args": ["-y", "emailpilot-mcp-server"], "env": { "EMAILPILOT_AUTH_TOKEN": "your-token-here" } } } }ℹ️ Adding to existing config: If you already have other MCP servers configured, add "emailpilot": {...} inside your existing "mcpServers" object. Don’t replace the entire file.
Step 3: Restart Claude Desktop
Quit Claude Desktop completely (Cmd+Q on macOS, or right-click the system tray icon on Windows and select Quit), then reopen it.
Step 4: Verify the Connection
Look for the hammer icon (🔨) in the chat input area. Click it to see the available EmailPilot tools. Try asking:
List my EmailPilot brandsSetting Up Cursor
Cursor is an AI-powered code editor. To connect it to EmailPilot:
Open Cursor and go to Settings (Cmd+, on macOS)
Navigate to Cursor Settings → MCP
Click Add Server
Enter the following configuration:
{ "emailpilot": { "command": "npx", "args": ["-y", "emailpilot-mcp-server"], "env": { "EMAILPILOT_AUTH_TOKEN": "your-token-here" } } }Setting Up VS Code
VS Code supports MCP through extensions. Here’s the configuration:
Install a compatible MCP extension from the VS Code marketplace
Open the Command Palette (Cmd+Shift+P)
Search for “MCP: Edit User Configuration”
Add the EmailPilot server:
{ "mcp.servers": { "emailpilot": { "command": "npx", "args": ["-y", "emailpilot-mcp-server"], "env": { "EMAILPILOT_AUTH_TOKEN": "your-token-here" } } } }Available Tools
The EmailPilot MCP server provides the following tools:
Example Queries
Once configured, try these example prompts with Claude:
📅 Campaign Calendar
“Show me the March 2026 email calendar for Faceman’s Coffee”
“What SMS campaigns are scheduled for next week?”
“List all promotional emails for Q1”
📊 Revenue Goals
“How are we tracking against our monthly revenue goal?”
“Show me the YTD revenue performance”
“What’s the variance for February?”
🎨 Creative Guidelines
“What subject line patterns work best for this brand?”
“When is the best time to send promotional emails?”
“Which segments have the highest click rates?”
📦 Product Analytics
“What are our hero products?”
“Which products are declining in sales?”
“Show me seasonal product trends”
Access Tiers
The EmailPilot MCP server uses a three-tier access model:
Troubleshooting
Claude doesn’t show the hammer icon
Verify your config file is valid JSON (use a JSON validator)
Check the file path is correct for your operating system
Ensure you’ve fully quit and restarted Claude Desktop
Check that Node.js is installed (node --version)
Error: “Authentication required”
Ensure you’ve added your MCP token to the configuration
Verify the token hasn’t expired (tokens last 90 days)
Regenerate your token from the Organization Dashboard
Error: “Access denied” for a brand
You can only access brands assigned to your user account
Contact your organization admin to get brand access
The free tier only allows access to the demo brand
Tools are slow or timing out
Check your internet connection
The first request may be slow as the server initializes
Large calendars may take a few seconds to retrieve
Still having issues?
Contact support at support@emailpilot.ai or visit our GitHub Issues page.
Get Started Now
Ready to connect Claude to your EmailPilot data?
Generate Your MCP Token →
Don’t have an EmailPilot account? Sign up for free and try the demo brand.