Skip to main content

fastmcp-trello

PyPI Python CI License: MIT

A Trello MCP server — manage boards, cards, and lists from any AI assistant that supports the Model Context Protocol. MCP is an open standard that lets AI assistants like Claude, Cursor, and Copilot interact with external tools and services.

Trello MCP Tools

Tool Description
get_boards List all boards accessible to you
get_board Get a board's details including its lists
get_lists Get all open lists on a board
create_board Create a new board
update_board Update a board's name or description
close_board Close (archive) a board
get_cards Get all cards in a list
get_card Get full details for a card including comments
create_card Create a new card on a list
update_card Update a card's fields or move it to a different list
archive_card Archive (close) a card
get_labels Get all labels defined on a board
create_label Create a new label on a board
delete_label Delete a label from a board
add_label_to_card Add a label to a card
remove_label_from_card Remove a label from a card
create_list Create a new list on a board
update_list Rename a list
archive_list Archive (close) a list
move_list Move a list to a new position
get_attachments Get all attachments on a card
add_attachment Add a URL attachment to a card
delete_attachment Delete an attachment from a card
add_comment Add a comment to a card
search_cards Search for cards across boards, optionally scoped to a specific board

Prerequisites

You need a Trello API key and token:

  1. Go to the Trello Power-Ups admin page
  2. Create a new Power-Up (any name/workspace will do)
  3. Generate a new API key
  4. From the API key page, click the Token link to generate a token

Installation

Add the following to your MCP client configuration (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["fastmcp-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Or run standalone:

TRELLO_API_KEY=your-api-key TRELLO_TOKEN=your-token uvx fastmcp-trello

Usage

Once installed in your MCP client, you can ask your AI assistant things like:

"Show me all my Trello boards"

"Create a card called 'Fix login bug' in the To Do list on my Project board"

Configuration

Variable Required Description
TRELLO_API_KEY Yes Your Trello API key
TRELLO_TOKEN Yes Your Trello authentication token

Development

git clone https://github.com/Jimdrews/fastmcp-trello.git
cd fastmcp-trello
uv sync --group dev
uv run pytest

See CONTRIBUTING.md for more details.

License

MIT

Metadata

Release files for fastmcp-trello 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fastmcp-trello 0.5.0
File Size Uploaded
fastmcp_trello-0.5.0.tar.gz 85.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fastmcp-trello 0.5.0
File Interpreter ABI Platform
fastmcp_trello-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 98.9 kB

Release files / fastmcp_trello-0.5.0.tar.gz

Download URL fastmcp_trello-0.5.0.tar.gz
Size 85.8 kB
Tags Source
SHA-256 checksum
How to use checksums
70ef0437b28cee62ce264b722a36b4fdbaaca9a5dcac33024bf57dac4f707498
BLAKE2b-256 checksum
How to use checksums
d047148cc1cfc7fcf46822a22d124cb9e8b74b26e47265f98e84cdcdcd1005d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / fastmcp_trello-0.5.0-py3-none-any.whl

Download URL fastmcp_trello-0.5.0-py3-none-any.whl
Size 13.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
77266d82abac01230d2ad64e74a173b6878d90dedb5c6589915360cd51c361d2
BLAKE2b-256 checksum
How to use checksums
24afa1b08f202e676a4dd9f4c7372b14c945974ee63eb603be9c1de663b504a8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.5.0 This release

2 release files

0.4.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page