trello-mcp-server 1.0.1

Model Context Protocol server for Trello API integration

Trello MCP Server

A Model Context Protocol (MCP) server that provides programmatic access to Trello's API. Manage boards, lists, cards, and organizations directly from any MCP-compatible client.

Quick Start

1. Install

# Using uvx (recommended)
uvx trello-mcp-server

# Using uv
uv tool install trello-mcp-server

# Using pip
pip install trello-mcp-server

2. Get API Key

Visit https://trello.com/power-ups/admin/new and create a Power-Up to get your API key (free, takes seconds).

3. Configure MCP Client

Add to your MCP settings configuration file:

{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["trello-mcp-server"],
      "env": {
        "TRELLO_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. Authenticate

On first use, the server automatically opens your browser to authorize access. Click "Allow" and you're done!

Features

• Boards: List and get board details
• Lists: List and create board lists
• Cards: List, create, and update cards (including moving between lists)
• Organizations: Manage workspaces, boards, and team members

Development

Setup

# Quick setup
./setup.sh

# Or manually
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Authentication

# Interactive (opens browser)
python -m trello_mcp_server.auth --interactive

# Manual (copy-paste token)
python -m trello_mcp_server.auth --manual

# Check status
python -m trello_mcp_server.auth --check

Testing

# Run tests
python -m pytest

# Test organization tools
python test_organizations.py

Documentation

• docs/AUTHENTICATION.md - Detailed authentication flows
• docs/ORGANIZATIONS.md - Organization management guide
• docs/STARTUP_FLOW.md - Server startup process
• docs/FUTURE_FEATURES.md - Planned features
• CHANGELOG.md - Version history

Architecture

• Language: Python 3.8+
• Protocol: MCP with stdio transport
• Authentication: OAuth 1.0a with automatic token caching
• Token Storage: ~/.trello_mcp_token.json (600 permissions)

Security

• API keys stored in MCP configuration (safe to share within team)
• Tokens stored in home directory (never committed)
• Automatic file permissions (600) on token cache
• Tokens never expire unless manually revoked

Support

• Trello API: https://developer.atlassian.com/cloud/trello/
• Get API Key: https://trello.com/power-ups/admin/new
• Manage Tokens: https://trello.com/my/account

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

git clone https://github.com/cargom98/gm-trello-mcp.git
cd gm-trello-mcp
./setup.sh

Running Tests

python -m pytest
python test_auth.py
python test_organizations.py

Releasing

See RELEASING.md for detailed release instructions.

Quick release:

./release.sh

License

See LICENSE file for details.