Drip MCP Server

A Model Context Protocol (MCP) server that enables Claude Code and other MCP clients to interact with Drip's email marketing platform. This server provides comprehensive tools for managing subscribers, campaigns, tags, events, and workflows.

Features

Core Capabilities

• Subscriber Management: Create, update, list, fetch, and unsubscribe subscribers
• Tag Management: Apply and remove tags for segmentation
• Event Tracking: Record custom events for behavioral triggers
• Campaign Management: List campaigns, subscribe/unsubscribe users from email series
• Workflow Automation: List, activate, pause workflows, and start subscribers on workflows
• Batch Operations: Efficiently handle bulk subscriber updates
• Custom Fields: List and manage custom field identifiers

Smart Features

• Dual Response Formats: All tools support both JSON (for processing) and Markdown (for readability)
• Pagination Support: Handle large datasets efficiently with built-in pagination
• Character Limit Protection: Automatic response truncation with helpful guidance
• Comprehensive Error Handling: Clear, actionable error messages
• GDPR Compliance: Built-in support for EU consent management

Installation

Prerequisites

• Python 3.8 or higher
• Drip account with API access
• MCP-compatible client (e.g., Claude Code)

Quick Install

We provide installation helper scripts to make setup easier:

Option 1: Python Installation Helper (Recommended)

python scripts/install_helper.py

Option 2: Bash Installation Script

chmod +x scripts/install.sh
./scripts/install.sh

Option 3: Manual Installation

Step 1: Clone or Download

# Save the files to your desired directory
mkdir ~/drip-mcp
cd ~/drip-mcp

Step 2: Install Dependencies

pip install httpx pydantic

# Install MCP SDK (try one of these methods):
pip install mcp

# If that doesn't work, try from GitHub:
pip install git+https://github.com/modelcontextprotocol/python-sdk.git

# Or clone and install locally:
git clone https://github.com/modelcontextprotocol/python-sdk.git
cd python-sdk
pip install -e .
cd ..

Step 3: Set Environment Variables

# Get these from your Drip account
export DRIP_API_KEY='your-api-key-here'
export DRIP_ACCOUNT_ID='your-account-id-here'

Finding Your Credentials:

• API Key: Drip Dashboard Settings My User Settings API Token
• Account ID: Look at your Drip dashboard URL (the number in the URL)

Step 4: Test the Server

# Test that the server starts correctly
python -m drip_mcp.server --help

# Or run the test script
python tests/test_server.py

Usage with Claude Code

Configure Claude Code

Add the following to your Claude Code configuration file (~/.config/claude/claude_config.json or equivalent):

{
  "mcpServers": {
    "drip": {
      "command": "python",
      "args": ["-m", "drip_mcp.server"],
      "cwd": "/absolute/path/to/drip_mcp",
      "env": {
        "DRIP_API_KEY": "your-api-key",
        "DRIP_ACCOUNT_ID": "your-account-id",
        "PYTHONPATH": "/absolute/path/to/drip_mcp/src"
      }
    }
  }
}

See docs/claude_code_config_example.json for a complete configuration example.

Example Commands in Claude Code

Once configured, you can use natural language to interact with Drip:

// Subscriber Management
"Add john@example.com to Drip with the tag 'Customer'"
"List all active subscribers"
"Show me details for jane@example.com"
"Unsubscribe user@example.com from all emails"

// Tag Management
"Apply the 'VIP' tag to customer@example.com"
"Show me all tags in my Drip account"
"Remove the 'Trial' tag from user@example.com"

// Event Tracking
"Record a 'Started Trial' event for new@example.com"
"Track a purchase of $99.99 for customer@example.com"
"List all custom events we're tracking"

// Campaign Management
"List all active email campaigns"
"Subscribe lead@example.com to campaign 123456"
"Remove subscriber@example.com from all campaigns"

// Workflow Automation
"Show me all workflows"
"Activate workflow 789012"
"Start john@example.com on the onboarding workflow"

// Batch Operations
"Import these 50 subscribers from a CSV"
"Update tags for multiple subscribers at once"

Available Tools

Subscriber Management

• drip_create_update_subscriber - Create or update a subscriber
• drip_list_subscribers - List subscribers with filtering
• drip_fetch_subscriber - Get detailed subscriber information
• drip_unsubscribe_from_all - Globally unsubscribe a subscriber
• drip_batch_subscribe - Batch create/update up to 1000 subscribers

Tag Management

• drip_list_tags - List all tags in the account
• drip_apply_tag - Apply a tag to a subscriber
• drip_remove_tag - Remove a tag from a subscriber

Event Tracking

• drip_record_event - Record a custom event for a subscriber
• drip_list_event_actions - List all event types being tracked

Campaign Management

• drip_list_campaigns - List Email Series Campaigns
• drip_subscribe_to_campaign - Subscribe someone to a campaign
• drip_unsubscribe_from_campaign - Remove from campaign(s)

Workflow Management

• drip_list_workflows - List all workflows
• drip_activate_workflow - Activate a workflow
• drip_pause_workflow - Pause a workflow
• drip_start_on_workflow - Start a subscriber on a workflow

Utility Tools

• drip_list_custom_fields - List custom field identifiers

Tool Parameters

Most tools support these common parameters:

Response Format

• response_format: Choose between "markdown" (human-readable) or "json" (machine-readable)

Pagination

• page: Page number (starts at 1)
• per_page: Results per page (max 100)

Filtering

• status: Filter by subscriber/campaign status
• tags: Filter by tags (comma-separated)
• sort: Sort results by different fields

Examples

Python Scr…