Skip to main content

Connect ChatGPT and Codex to the Woodpecker MCP server

Connect Woodpecker to ChatGPT or Codex in just a few steps - no local server or API key required. Once connected, you can chat with ChatGPT or Codex to manage your campaigns, prospects, and email sequences.

Connecting ChatGPT and Codex​

Choose whether you want to connect through the ChatGPT desktop app or Codex CLI.

First add the Woodpecker MCP server, then authorize access to your Woodpecker account.

  1. In the ChatGPT desktop app, open Settings and select Plugins.

  2. Select Add in the top-right corner, then Add MCP Server.

    ChatGPT Plugins settings with the Add menu open and Add MCP server highlighted

  3. Enter a name for the server, for example woodpecker.

  4. Set Type to Streamable HTTP and enter the following URL:

    https://api.woodpecker.co/mcp/v1

  5. Select Save.

    ChatGPT MCP server configuration with the Woodpecker name, Streamable HTTP type, and server URL entered

  6. Open the MCPs tab and select Authenticate for the Woodpecker MCP server.

    ChatGPT MCPs tab showing the Woodpecker server and its Authenticate button

  7. Sign in to your Woodpecker account when prompted.

  8. Review the requested access and select Allow.

    Woodpecker authorization screen listing the permissions requested by chatgpt.com and the Allow button

After authorization, ChatGPT can use the available Woodpecker tools.

To verify the connection, ask ChatGPT:

"What Woodpecker tools do you have access to?"
"List my Woodpecker campaigns"

Troubleshoot the ChatGPT or Codex connection​

Authorization was not completed

Symptoms: The Woodpecker MCP server has been added, but the app still asks you to authenticate.

  • In ChatGPT Desktop, open Settings → Plugins → MCPs and select Authenticate for Woodpecker
  • In Codex CLI, run codex mcp login woodpecker
  • Sign in to the intended Woodpecker account and complete the authorization by selecting Allow. Saving the server configuration alone does not authorize access to your account.

The app cannot connect to the MCP server

Symptoms: The app reports a connection error when adding or using the Woodpecker MCP server.

  • Check that the server URL is exactly https://api.woodpecker.co/mcp/v1
  • In ChatGPT Desktop, make sure Type is set to Streamable HTTP
  • In Codex CLI, use codex mcp list to check the configured server URL

An Agency client account cannot be selected

Symptoms: You connected an Agency account but cannot access or switch to one of its client accounts.

  • The hosted Woodpecker MCP server does not currently support selecting client accounts managed under an Agency account. To work with Agency client accounts, run the MCP server locally with Docker and authenticate it with the appropriate Woodpecker API key.