Woodpecker MCP Server

Name: Woodpecker MCP Server
Author: Woodpeckerco

@Woodpeckerco

About Woodpecker MCP Server

The Woodpecker MCP (Model Context Protocol) integration transforms cold email campaign management into a conversational experience.

#coldemail #automation #ai

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "woodpecker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WOODPECKER_API_KEY",
        "woodpeckerco/woodpecker-mcp-server"
      ],
      "env": {
        "WOODPECKER_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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?

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.