Woodpecker MCP Server

The Woodpecker MCP (Model Context Protocol) server lets AI agents interact directly with your Woodpecker account.

Connect Claude and other compatible AI agents directly with your Woodpecker account. Use natural language to manage campaigns, prospects, email sequences, mailboxes, and campaign performance without calling the Woodpecker API manually.

You can start with straightforward tasks, such as listing campaigns or adding prospects, and move on to more advanced workflows, including multistep sequences, A/B testing, campaign configuration, and performance analysis.

Features

• 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

Prerequisites

Choose the connection method that matches your AI agent.

We recommend connecting Claude or Claude Code directly to the MCP server hosted by Woodpecker. This is the simplest and most reliable setup.

Alternatively, use Docker image if you want to use another compatible AI tool or MCP client, host the server yourself, or manage client accounts under a Woodpecker Agency account.

Both connection methods provide access to the same Woodpecker tools. The hosted connection uses an authorization flow currently supported only by Claude, while the Docker setup works with MCP clients that support stdio.

Connection method	Supported AI agents	Requirements
Connect Claude Hosted by Woodpecker - Recommended	Claude (web, desktop, and mobile) and Claude Code	A Woodpecker account and Claude
Run locally with Docker	Claude Desktop, Cursor, or another MCP client that supports stdio	A Woodpecker account with the API & Integration add-on enabled, a Woodpecker API key, and Docker