mcp-trello

MCP server for Trello. Manage boards, lists, cards, labels, and checklists from any AI agent.

No official or maintained MCP server exists for Trello. This is the first one.

Install

npm install -g mcp-trello

Or run directly with npx:

npx mcp-trello

Configuration

Get your Trello credentials

1. API Key: Go to trello.com/power-ups/admin/ and copy your API key
2. Token: Visit this URL (replace YOUR_KEY):

   https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&key=YOUR_KEY
   

Add to your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "mcp-trello"],
      "env": {
        "TRELLO_API_KEY": "your-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "mcp-trello"],
      "env": {
        "TRELLO_API_KEY": "your-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Gemini CLI (~/.config/gemini/settings.json):

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "mcp-trello"],
      "env": {
        "TRELLO_API_KEY": "your-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Available Tools

Boards

Lists

Cards

Labels

Checklists

Comments

Search

Example Prompts

Once configured, ask your AI agent:

• “Show me all cards in the Backlog list”
• “Move the login bug card to In Progress”
• “Create a card called ‘Update dependencies’ in the Sprint list”
• “Add a comment to card abc123 saying ‘Reviewed and approved’”
• “Search for all cards mentioning ‘authentication’”
• “Create a new board called ‘Q3 Roadmap’”

Development

git clone https://github.com/smarthomeo/mcp-trello.git
cd mcp-trello
npm install
npm test        # Run 72 tests
npm run build   # Build to dist/

License

MIT