How to Use the Woodpecker MCP in Claude

Q: Can I use Woodpecker to track webhooks in Claude Desktop?

Yeah, you can list them using the listwebhooks tool. This helps your agent check which endpoints are set up for campaign tracking or data retrieval from Woodpecker.

Q: What if I need to see all my campaigns in Claude Desktop?

You just call listcampaigns. The MCP Server returns a structured list that your agent uses. This is fast, and it keeps you from having to jump between the chat and the Woodpecker UI.

Q: How do I monitor deliverability stats with Woodpecker in Claude Desktop?

You use the getcampaignstats tool. This pulls key performance indicators about delivery and engagement directly into the agent, so you see the numbers right where you're working.

Manage cold email campaigns and prospect data directly in Claude Desktop’s chat window.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Woodpecker MCP to Claude Desktop

Create your Vinkius account to connect Woodpecker to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Woodpecker with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check campaign status.

Need to see what's going on with a sequence? The `list_campaigns` tool pulls all your active campaigns. You don't have to click around in the Woodpecker platform just for a list. The `get_campaign_stats` function gives you the numbers—open rates, bounces, whatever. It feeds that data straight into Claude Desktop so your agent can write reports based on real metrics.

Manage prospect lists.

The `list_prospects` tool lets your AI client pull the current list of leads. You get immediate context about who you're emailing without opening a web tab. Want to add someone new? Use `add_prospect` to feed Woodpecker directly from Claude Desktop. It’s like having an extra data entry form built into the chat input.

Control campaign flow.

Sometimes you gotta pause things—maybe a segment is performing poorly, or you're waiting on legal sign-off. The `pause_campaign` tool lets your agent hit that button. You can also use `resume_campaign` once the green light is given. These actions keep your entire cold email sequence managed right within Claude Desktop.

Setup guide

Set up Woodpecker MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Woodpecker MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Woodpecker MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under woodpecker-mcp.

json

{
  "mcpServers": {
    "woodpecker-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Woodpecker. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Woodpecker now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Woodpecker MCP in Claude Desktop

Your AI client connects to the Woodpecker MCP Server using either a local stdio subprocess or a remote HTTPS URL. This connection gives your agent direct API access, letting it run commands like `list_prospects` right from your chat window.

Yeah, you can list them using the `list_webhooks` tool. This helps your agent check which endpoints are set up for campaign tracking or data retrieval from Woodpecker.

You just call `list_campaigns`. The MCP Server returns a structured list that your agent uses. This is fast, and it keeps you from having to jump between the chat and the Woodpecker UI.

This server touches campaign metadata and prospect records (emails/names). The connection uses standard authentication protocols, meaning you control who sees that information via your endpoint token.

You use the `get_campaign_stats` tool. This pulls key performance indicators about delivery and engagement directly into the agent, so you see the numbers right where you're working.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript