MCP Directory

How to add Trello MCP to Windsurf

Comprehensive Trello integration for Claude Desktop, Claude Code, Gemini CLI and other MCP clients — 19 tools for boards, cards and lists. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 31★ · stdio · apikey

Windsurf config for Trello MCP

git clone https://github.com/kocakli/trello-desktop-mcp.git && cd trello-desktop-mcp && npm install && npm run build
{
  "mcpServers": {
    "trello-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/trello-desktop-mcp/dist/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "your-api-key-here",
        "TRELLO_TOKEN": "your-token-here"
      }
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Trello MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Trello MCP's tools become available to Cascade.

Before you start

  • Node.js 18+ installed
  • An MCP-compatible client (Claude Desktop, Claude Code, Gemini CLI, etc.)
  • A Trello account with API credentials (API Key and Token from https://trello.com/app-key)

What Trello MCP can do in Windsurf

trello_search

Universal search across all Trello content (boards, cards, members, organizations).

trello_get_user_boards

Get all boards accessible to the current user.

get_board_details

Get detailed board information including its lists and cards.

get_card

Get comprehensive card details including members, labels and checklists.

create_card

Create new cards in any list with descriptions, due dates and assignments.

update_card

Update card properties such as name, description, due date and status.

move_card

Move cards between lists to update workflow status.

trello_add_comment

Add comments to cards for team communication.

Security

Requires a Trello API key and a Trello token (read/write) from https://trello.com/app-key. Credentials are stored locally in the MCP client config and passed via the TRELLO_API_KEY and TRELLO_TOKEN environment variables; they are never transmitted over the network. All Trello API calls use HTTPS. Treat the token like a password — it grants read/write access to your Trello account.

Trello MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Trello MCP config there under the "mcpServers" key and restart the client.

Is Trello MCP safe to use with Windsurf?

Requires a Trello API key and a Trello token (read/write) from https://trello.com/app-key. Credentials are stored locally in the MCP client config and passed via the TRELLO_API_KEY and TRELLO_TOKEN environment variables; they are never transmitted over the network. All Trello API calls use HTTPS. Treat the token like a password — it grants read/write access to your Trello account.

Which MCP clients are supported?

Any MCP-compatible client that supports stdio transport, including Claude Desktop, Claude Code (CLI), Gemini CLI, and others. The README provides explicit config blocks for each.

How do I get Trello API credentials?

Visit https://trello.com/app-key, copy your API Key, and generate a Token with read/write access. Set them as TRELLO_API_KEY and TRELLO_TOKEN in your MCP client config.

Are my credentials sent anywhere?

No. Credentials are stored locally in your MCP client's config and are never transmitted over the network. All Trello API calls go directly to Trello over HTTPS.

View repo Full Trello MCP page