Woodpecker MCP Server

What is Woodpecker MCP Server?

The Woodpecker MCP Server connects your AI assistant to Woodpecker’s automation platform, letting you manage cold email campaigns through natural language. It is designed for sales, marketing, and growth teams who want to create, run, and analyze email outreach without leaving their chat interface.

How to use Woodpecker MCP Server?

Install Docker, get a Woodpecker API key from your account settings, then configure your MCP‑compatible AI agent (e.g., Claude Desktop) by adding a “woodpecker” server entry that runs the woodpeckerco/woodpecker-mcp-server Docker image with the WOODPECKER_API_KEY environment variable. After restarting the agent, you can ask it to list campaigns, create sequences, or perform other operations.

Key features of Woodpecker MCP Server

• Create, update, run, pause, and delete email campaigns
• Add, update, delete, and search prospect data
• Compose multi‑step email sequences with A/B testing
• Retrieve campaign statistics and performance metrics
• Assign email accounts to campaigns
• Configure delivery schedules, timezone, and GDPR compliance

Use cases of Woodpecker MCP Server

• Building and launching a cold email outreach campaign from scratch
• Bulk adding prospects with personalized snippets into a campaign
• Pausing a campaign and viewing its real‑time analytics
• Setting up follow‑up sequences with scheduling and A/B variants
• Updating campaign settings and daily enrollment limits via conversation

FAQ from Woodpecker MCP Server

What are the prerequisites for using Woodpecker MCP Server?

You need a Woodpecker account with the API & Integration add‑on enabled, a valid Woodpecker API key, Docker installed, and an MCP‑compatible AI agent (e.g., Claude Desktop or Continue.dev).

How do I get my Woodpecker API key?

Log in to your Woodpecker account, go to Marketplace → Integrations → API keys, and click “Create a key”.

How do I configure the server in Claude Desktop?

Edit claude_desktop_config.json (located in ~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows, or ~/.config/Claude/ on Linux) and add a "woodpecker" entry under mcpServers with "command": "docker", "args": ["run", "-i", "--rm", "-e", "WOODPECKER_API_KEY", "woodpeckerco/woodpecker-mcp-server"], and your key in the env object. Then restart Claude Desktop.

What transport does the server use?

The server uses stdio transport, as required by MCP‑compatible agents.

What should I do if campaign creation fails?

Ensure you have at least one email account configured in Woodpecker, verify the account ID using the listMailboxes tool, check that campaign parameters match the required format, and confirm your daily enrollment limit is greater than zero.