# trello-mcp

> A self-hosted, auditable Model Context Protocol server for broad Trello automation.

trello-mcp is an independent, community-maintained project. It is not an official Trello or Atlassian product, service, or MCP implementation, and it is not affiliated with, endorsed by, or sponsored by Trello or Atlassian.

## Documentation

- [Self-hosted, auditable Trello MCP server](https://trello-mcp.com/): A self-hosted, auditable Model Context Protocol server for broad Trello automation.
- [Install and run](https://trello-mcp.com/getting-started/): Create Trello credentials, choose a transport and installation path, configure your MCP client, then verify the connection.
- [Set up your MCP client](https://trello-mcp.com/getting-started/clients/): Configure trello-mcp over local stdio or Streamable HTTP in supported MCP clients.
- [Compatibility evidence](https://trello-mcp.com/getting-started/compatibility/): Dated evidence for MCP client setup, transport connection, tool discovery, and live Trello validation.
- [Docker Compose](https://trello-mcp.com/getting-started/docker/): Run the published trello-mcp image as a loopback-published Compose service, or build the image locally.
- [Streamable HTTP](https://trello-mcp.com/getting-started/http/): Connect an HTTP MCP client to trello-mcp on loopback and understand the wider-network boundary.
- [stdio](https://trello-mcp.com/getting-started/stdio/): Let a local desktop MCP client launch trello-mcp as a child process without a network listener.
- [Trello API key](https://trello-mcp.com/getting-started/trello-api-key/): Create a Trello app, generate an API key, authorize a token, store both credentials safely, and verify them with trello-mcp.
- [FAQ](https://trello-mcp.com/guides/faq/): Answers about trello-mcp hosting, credentials, transports, Trello access, destructive tools, privacy, support, and the official Trello MCP server.
- [How it works](https://trello-mcp.com/guides/how-it-works/): Follow a tool call across the MCP client, trello-mcp, and the Trello REST API.
- [Operate trello-mcp](https://trello-mcp.com/guides/operations/): Upgrade, roll back, inspect, stop, and rotate credentials for a running trello-mcp deployment.
- [Security and data flow](https://trello-mcp.com/guides/security/): Understand how trello-mcp handles credentials, Trello data, transports, logs, attachment uploads, and write operations.
- [Troubleshooting](https://trello-mcp.com/guides/troubleshooting/): Diagnose startup, transport, authentication, Docker, Trello API, rate-limit, and attachment failures safely.
- [Workflows](https://trello-mcp.com/guides/workflows/): Practical Trello workflows expressed through the MCP tool catalog.
- [Reference](https://trello-mcp.com/reference/): Technical reference, contribution guidance, issue reporting, release resources, and security policies for trello-mcp.
- [API coverage](https://trello-mcp.com/reference/api-coverage/): Supported, partially supported, deferred, and out-of-scope Trello REST API groups.
- [Configuration reference](https://trello-mcp.com/reference/configuration/): Every trello-mcp runtime and Compose setting, its default, and the boundary it controls.
- [Contributing](https://trello-mcp.com/reference/contributing/): Run the project checks, update canonical documentation, follow the Trello tool pattern, and prepare focused contributions safely.
- [Reporting issues and support](https://trello-mcp.com/reference/reporting-issues/): Choose the right support channel and prepare a useful, sanitized trello-mcp bug report.
- [Security policy](https://trello-mcp.com/reference/security-policy/): Supported versions, private vulnerability reporting, sensitive data handling, and threat-model boundaries for trello-mcp.
- [Tool catalog](https://trello-mcp.com/reference/tools/): Search 77 Trello MCP tools by category, behavior, name, purpose, and input.

## Source

- [GitHub repository](https://github.com/enthouan/trello-mcp)
- [Official Trello MCP](https://trello.com/mcp), hosted at https://mcp.trello.com/v1