Trello MCP Server

What is Trello MCP Server?

A Model Context Protocol (MCP) server that integrates Trello with AI hosts like Claude Desktop. It enables reading boards, lists, cards, and checklists, as well as creating, updating, and deleting lists, cards, and checklists via natural language queries.

How to use Trello MCP Server?

Install Python 3.12+, uv, and obtain Trello API credentials. Set up a .env file with TRELLO_API_KEY and TRELLO_TOKEN. Clone the repository, run uv run mcp install main.py to register with Claude Desktop, and restart the app. Alternatively, run python main.py with USE_CLAUDE_APP=false for SSE mode, then connect any MCP client (e.g., Cursor) to http://localhost:8000.

Key features of Trello MCP Server

• Read all boards and specific board details.
• Create, read, update, and archive lists.
• Create, read, update, and delete cards.
• Full checklist CRUD (including checkitems).
• Two operation modes: Claude App and standalone SSE server.
• Docker support via docker-compose up -d.
• Environment‑variable configuration (USE_CLAUDE_APP, ports, etc.).

Use cases of Trello MCP Server

• Ask Claude to list all your Trello boards.
• Create a new card in a specific list with a given title.
• Update the description or attributes of an existing card.
• Archive (delete) a list you no longer need.
• Add a new card complete with a checklist of items.

FAQ from Trello MCP Server

What prerequisites are required?

Python 3.12+, the uv package manager, a Trello account with API key and token, and (for Claude App mode) the Claude Desktop application installed and logged in.

How do I run it with Cursor?

Set USE_CLAUDE_APP=false in .env, start the server with python main.py, then in Cursor go to Settings > AI > Model Context Protocol and add a server with URL http://localhost:8000. Alternatively, add a JSON configuration in ~/.cursor/mcp.json.

Can I run it in Docker?

Yes. After creating your .env file, run docker-compose up -d. It runs in SSE mode by default. Use docker-compose logs -f to view logs and docker-compose down to stop.

What board operations are supported?

Only read operations: you can list all boards and view details of a specific board. Write, update, and delete are not available for boards; those operations are supported for lists, cards, and checklists.

How do I obtain Trello API credentials?

Go to Trello Power‑Ups Admin, create a new integration, select your workspace, then copy the API key from the app’s page and manually generate a token from the same page.