@sanders248/trello-mcp
v0.1.0
Published
Remote MCP server and library for Trello boards.
Readme
Trello MCP
Remote MCP server and TypeScript library for operating on allowlisted Trello boards through Trello OAuth.
Install
npm install @sanders248/trello-mcpRun
MCP_PUBLIC_URL=http://localhost:8787 \
MCP_DATABASE_URL=postgresql://trello_mcp:trello_mcp@localhost:5432/trello_mcp \
TRELLO_API_KEY=... \
TRELLO_API_SECRET=... \
TRELLO_ALLOWED_BOARD_IDS=... \
TOKEN_ENCRYPTION_KEY="$(openssl rand -base64 32)" \
npx trello-mcpThe server exposes:
GET /healthzGET /.well-known/oauth-protected-resourceGET /.well-known/oauth-authorization-serverPOST /oauth/registerGET /oauth/authorizePOST /oauth/tokenPOST /oauth/revokeALL /mcp
Configuration
| Variable | Description |
|---|---|
| PORT | HTTP port, defaults to 8787. |
| MCP_PUBLIC_URL | Public base URL, for example https://mcp.example.com. |
| MCP_RESOURCE | Optional OAuth resource URL, defaults to ${MCP_PUBLIC_URL}/mcp. |
| MCP_SERVER_NAME | Optional MCP server name, defaults to trello-mcp. |
| TRELLO_OAUTH_APP_NAME | Optional Trello OAuth display name, defaults to Trello MCP. |
| MCP_DATABASE_URL | PostgreSQL connection string. |
| MCP_DATABASE_HOST / MCP_DATABASE_PORT / MCP_DATABASE_NAME / MCP_DATABASE_USER / MCP_DATABASE_PASSWORD | PostgreSQL settings when MCP_DATABASE_URL is not used. |
| TRELLO_API_KEY / TRELLO_API_SECRET | Trello developer app credentials. |
| TRELLO_ALLOWED_BOARD_IDS | Comma-separated Trello board IDs or short links allowed by the server. |
| ALLOWED_TRELLO_MEMBER_IDS | Optional comma-separated Trello member IDs allowed to connect. |
| TOKEN_ENCRYPTION_KEY | 32-byte key as base64, hex, or utf8. |
| MCP_ACCESS_TOKEN_TTL_SECONDS | Access token TTL, defaults to 2592000. |
| MCP_AUTH_CODE_TTL_SECONDS | OAuth code TTL, defaults to 300. |
Library API
import { createTrelloMcpApp, startTrelloMcpServer, TrelloClient } from "@sanders248/trello-mcp";The package also exports MCP helpers and Trello DTO types for embedding or testing.
Docker
docker run --rm -p 8787:8787 --env-file .env ghcr.io/sanders248/trello-mcp:latest