Woodpecker CI MCP Server: Install & Setup

Install Woodpecker CI in Claude Code

npm

Claude Code

claude mcp add woodpecker-ci -e WOODPECKER_URL=... -e WOODPECKER_TOKEN=... -- npx -y @ni-c/woodpecker-ci-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "woodpecker-ci": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/woodpecker-ci-mcp"
      ],
      "env": {
        "WOODPECKER_URL": "...",
        "WOODPECKER_TOKEN": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add woodpecker-ci -e WOODPECKER_URL=... -e WOODPECKER_TOKEN=... -- docker run -i --rm -e WOODPECKER_URL -e WOODPECKER_TOKEN ghcr.io/ni-c/woodpecker-ci-mcp:0.4.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "woodpecker-ci": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WOODPECKER_URL",
        "-e",
        "WOODPECKER_TOKEN",
        "ghcr.io/ni-c/woodpecker-ci-mcp:0.4.0"
      ],
      "env": {
        "WOODPECKER_URL": "...",
        "WOODPECKER_TOKEN": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Woodpecker CI MCP server do?

Drive a self-hosted Woodpecker CI: read failing step logs, restart, cancel or approve pipelines, and manage secrets, registries, crons, agents and the queue.

Is the Woodpecker CI MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does Woodpecker CI run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Woodpecker CI to Claude Code?

Run: claude mcp add woodpecker-ci -e WOODPECKER_URL=... -e WOODPECKER_TOKEN=... -- npx -y @ni-c/woodpecker-ci-mcp

More developer tools MCP servers

View all

ADITUS Developer Portal

ADITUS Developer Portal MCP

Search and read the ADITUS event-technology API docs (ticketing, access, BI) and Shop Micro Frontend guides.

RemoteFree

whichlib

01.3k

josifb/whichlib

Dependency picker for coding agents: recommends and compares GitHub repos for a need, scored 0-100 on momentum, maintenance, npm/PyPI downloads and license, with a one-line verdict.

Local + RemoteFreeTypeScript

Aeon

Run and manage your Aeon autonomous agent on GitHub Actions: skills, runs, memory, strategy and settings.

RemoteAccount needed

Tuning Engines

612

cerebrixos-org/tuning-engines-cli

Fine-tune open-source LLMs (Qwen, Llama, DeepSeek, Mistral, Gemma) on your data with LoRA, QLoRA or full fine-tuning, plus cost estimation and S3 export.

LocalAccount neededTypeScript

Agent Stack Directory

gmansystems/agent-stack-directory

Search, inspect and compare AI agent infrastructure tools (cloud browsers, code sandboxes, memory, search APIs and more) from the Agent Stack Directory open dataset. Read-only, no API key.

RemoteFreeTypeScript

Symfony Agent

shakaran/symfony-agent-mcp

Read-only introspection of Symfony codebases: routes, controllers, services, entities, schema, migrations, Doctrine, Messenger, Twig and API Platform.

LocalFreeTypeScript