trello-mcp server

trello-mcp

A local Trello MCP server in Go. Your AI assistant manages boards, cards, checklists and attachments over stdio, with compact curated responses, workspace allowlists and a read-only opt-in.

Install

curl -fsSL https://raw.githubusercontent.com/avhn/trello-mcp/main/install.sh | sh

Windows PowerShell: irm https://raw.githubusercontent.com/avhn/trello-mcp/main/install.ps1 | iex. Both verify SHA-256 and fail closed instead of building from source.

Or give your agent this line and let it follow the canonical setup guide:

Set up trello-mcp by following https://raw.githubusercontent.com/avhn/trello-mcp/main/docs/setup.md; ask me to run its printed absolute-path auth command myself in a private terminal, then reconnect. Never capture authentication output.

Quick start

PowerShell to %LOCALAPPDATA%\Programs\trello-mcp. The installer prints quoted absolute-path commands for auth, status, version and registration; use those.

1. Install the binary (above) and note its absolute path: POSIX defaults to ~/.local/bin, Windows

1. Register it with your client. Claude Code, user scope:

claude mcp add --scope user --transport stdio trello -- "/absolute/path/to/trello-mcp"

Replace the quoted placeholder with the concrete installed path; prefer the printed registration. Claude Desktop, Codex CLI and desktop, ChatGPT desktop, OpenCode, Cursor and VS Code snippets, with exact file locations and reload steps, are in docs/setup.md.

them to ~/.secrets/.trello-mcp.secret; write access is the default and --read-only opts out. Never run it where an agent captures the output or paste keys, tokens or authorization links into chat.

1. Run the printed absolute-path trello-mcp auth yourself in a private terminal. It validates your Trello API key and token and saves

for local presence/source, metadata for version and policy for restrictions. Then call workspacefind {} for actual Trello access: health ok and credentialSource do not validate auth. Empty success still proves the read worked. Until a fresh configured server starts only serverhealth is exposed, and every health detail then returns just the setup response; version and policy fields need credentials.

1. Use the trello server's Reconnect action in /mcp or restart the client, then call server_health

Claude Desktop bundles support macOS and Windows amd64 (owner-tested at v0.6.0; Windows on Arm is not claimed); Linux Desktop remains beta. Download bundles from GitHub releases, verify checksums, and install/update manually. Registry discovery is separate from Desktop installation. Create the key/token in a browser and use extension settings, not CLI auth. Removal uses Desktop controls, not CLI logout; settings migration and token revocation are not guaranteed. See docs/setup.md.

Update, rollback, uninstall and revocation are in docs/setup.md. Variables, credential precedence and permissions are in docs/configuration.md.

Usage

Shortened. The full README is on GitHub.