How to add MCP Server Trello (delorenj) to Windsurf

Interact with Trello boards — cards, lists, comments — with built-in rate limiting and type safety. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 370★ · stdio · apikey

Windsurf config for MCP Server Trello (delorenj)

npx -y @delorenj/mcp-server-trello

{
  "mcpServers": {
    "mcp-server-trello-delorenj": {
      "command": "npx",
      "args": [
        "-y",
        "@delorenj/mcp-server-trello"
      ],
      "env": {
        "TRELLO_TOKEN": "<your-trello-token>",
        "TRELLO_API_KEY": "<your-trello-api-key>",
        "TRELLO_BOARD_ID": "<optional-default-board-id>"
      }
    }
  }
}

Setup steps

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

Before you start

Node.js 16+ (Bun v1.0.0+ recommended; runs fine via npx/pnpx/bunx)
A Trello API key from https://trello.com/app-key, set as TRELLO_API_KEY
A Trello API token generated from that key, set as TRELLO_TOKEN
Optional: TRELLO_WORKSPACE_ID, TRELLO_ALLOWED_WORKSPACES (comma-separated allowlist), and https_proxy for restricted networks

What MCP Server Trello (delorenj) can do in Windsurf

list_boards

List the boards you have access to

set_active_board

Switch the active board at runtime (persists to config)

get_active_board_info

Get info about the currently active board

get_lists

List the lists on the active board

add_list_to_board

Create a new list on the board

get_cards_by_list_id

Get all cards in a given list

add_card_to_list

Create a new card in a list

update_card_details

Edit a card's name, description, due date, labels, etc.

Security

Requires a Trello API key and user token that grant access to your boards; store both in env vars and use TRELLO_ALLOWED_WORKSPACES to restrict scope. Tokens are long-lived, so revoke them from Trello if exposed.

MCP Server Trello (delorenj) + Windsurf FAQ

Where is the Windsurf config file?

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

Is MCP Server Trello (delorenj) safe to use with Windsurf?

Where do I get the API key and token?

Create the API key at https://trello.com/app-key, then use it to generate a user token (also linked from that page). Set them as TRELLO_API_KEY and TRELLO_TOKEN.

Can I use more than one board?

Yes. Use set_active_board / set_active_workspace to switch context at runtime — preferences persist to ~/.trello-mcp/config.json — and most tools also accept an optional boardId. The older TRELLO_BOARD_ID env var is deprecated but still supported.

Will it hit Trello's rate limits?

It implements a token-bucket limiter matching Trello's quotas (300/10s per key, 100/10s per token) and automatically queues requests that would exceed them, so you avoid 429 errors.

View repo Full MCP Server Trello (delorenj) page