Woodpecker MCP Server

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

Local serverstdioGo

What is the Woodpecker MCP Server?

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

What it actually does

  • Campaign Management — Create, update, run, pause and delete email campaigns
  • Prospect Operations — Add prospects to your account and campaigns, update and delete prospect data, search prospects
  • Email Composition — Create multistep email sequences with A/B testing capabilities
  • Analytics & Reporting — Retrieve campaign statistics and performance metrics
  • Mailbox Integration — Assign email accounts to campaigns
  • Advanced Configuration — Support for delivery schedules, timezone settings and GDPR compliance

Recorded tools

  • createCampaign — Create campaigns with basic configuration including subjects, messages and delivery settings. Supports full templating with snippets, fallbacks and spintax for personalized content.
  • createAdvancedCampaign — Create campaigns with full API capabilities including A/B testing and complex delivery schedules.
  • listCampaigns — The listCampaigns tool exposed by this server.
  • retrieveCampaignDetails — Get detailed campaign structure including all steps and configurations.
  • retrieveCampaignStatistics — The retrieveCampaignStatistics tool exposed by this server.
  • updateCampaignSettings — Modify campaign-wide settings including name, email accounts, daily limits and timezone.
  • buildCampaignUrl — The buildCampaignUrl tool exposed by this server.
  • addStep — The addStep tool exposed by this server.
  • updateCampaignStep — The updateCampaignStep tool exposed by this server.
  • updateStepVersion — Update email content, subject lines, signatures and tracking settings.
  • deleteCampaignStep — The deleteCampaignStep tool exposed by this server.
  • addProspectsToDatabase — Adds new prospects to your global prospect list without enrolling them in any campaign.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
runCampaigncampaignId): Start campaign execution
pauseCampaigncampaignId): Pause campaign
stopCampaigncampaignId): Stop campaign
deleteCampaigncampaignId): Remove campaign entirely
makeCampaignEditablecampaignId): Enable campaign modifications

How to install the Woodpecker MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Before setting up the integration, ensure you have: - Woodpecker Account: An account with the API & Integration add-on enabled - API Credentials: Woodpecker API key (found in your account settings) - Docker: Installed on your system (for running the MCP server) https://docs.docker.com/desktop/ - AI Agent: Claude Desktop, Continue.dev or another

VariableDescriptionRequired
WOODPECKER_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Woodpecker to Prerequisites.”
  • “Use Woodpecker to Troubleshooting.”
  • “Use Woodpecker to createCampaign.”

Frequently asked questions

The Woodpecker MCP (Model Context Protocol) integration transforms cold email campaign management into a conversational experience. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.