Trello MCP Server

A custom Model Context Protocol server that connects Claude to the Trello API. Deployed on Val Town as an HTTP endpoint using the Streamable HTTP transport.

Setup

1. Get Trello API credentials

Go to https://trello.com/power-ups/admin and create a Power-Up (or use the API key section)
Copy your API Key

Generate a token by visiting this URL in your browser (replace YOUR_API_KEY):

https://trello.com/1/authorize?expiration=30days&name=TrelloMCP&scope=read,write&response_type=token&key=YOUR_API_KEY

2. Add environment variables

Add these two secrets to the val:

TRELLO_API_KEY — your Trello API key
TRELLO_TOKEN — your Trello token

👉 Add TRELLO_API_KEY here: https://www.val.town/x/jc_marketing/trello-mcp/environment-variables?key=TRELLO_API_KEY 👉 Add TRELLO_TOKEN here: https://www.val.town/x/jc_marketing/trello-mcp/environment-variables?key=TRELLO_TOKEN

3. Connect to Claude

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "trello": {
      "url": "https://trello-mcp.val.run"
    }
  }
}

Claude API / Claude Code

Add the MCP server URL to your Claude configuration:

https://trello-mcp.val.run

Available Tools

Tool	Description
`get_boards`	List all Trello boards
`get_lists`	Get lists (columns) on a board
`get_cards`	Get cards on a board or in a list
`get_card`	Get details of a specific card
`create_card`	Create a new card
`update_card`	Update card name, description, due date, or move to another list
`archive_card`	Archive (close) a card
`add_comment`	Add a comment to a card
`get_comments`	Get all comments on a card
`get_labels`	Get labels on a board
`add_label`	Add a label to a card
`get_my_info`	Get authenticated user info

Architecture

Claude  ──POST JSON-RPC──►  main.ts (MCP HTTP handler)
                               │
                               ├── tools.ts (12 tool definitions)
                               │      │
                               │      └── trello.ts (Trello REST API client)
                               │             │
                               │             └── api.trello.com/2
                               │
                               └── JSON-RPC 2.0 response

main.ts — HTTP endpoint implementing MCP Streamable HTTP transport (JSON-RPC 2.0)
trello.ts — Trello REST API wrapper with auth via environment variables
tools.ts — 12 MCP tool definitions with JSON Schema input validation

Example Usage

Once connected, you can ask Claude things like:

"Show me all my Trello boards"
"Create a card called 'Review PR' in the To Do list on my Sprint board"
"Move the 'Bug fix' card to the Done list"
"Add a comment to the deployment card saying 'Deployed to staging'"
"What labels are on my Marketing board?"

jc_marketing

trello-mcp