Trello MCP Server
by
Provides a Model Context Protocol server that bridges Trello with AI assistants, enabling natural‑language management of boards, lists, and cards.
Trello MCP Server Overview
What is Trello MCP Server about?
Enables AI assistants such as Claude Desktop and GitHub Copilot Chat to interact with Trello through natural language, exposing Trello boards, lists, and cards as MCP resources.
How to use Trello MCP Server?
- Install – either clone the repository and run
npm installfollowed bynpm run build, or build the Docker image withdocker build -t trello-mcp-server .. - Configure credentials – obtain a Trello API key and token from https://trello.com/app-key and set the environment variables
TRELLO_API_KEY,TRELLO_TOKEN, andTRELLO_BASE_URL(defaulthttps://api.trello.com/1). - Run – for local usage execute
node dist/index.js; for Docker rundocker run --rm -i --env-file .env trello-mcp-server. - Add to MCP client – add a server entry to Claude Desktop or VS Code settings pointing to the compiled
dist/index.js(or the Docker command). The server will listen for MCP client connections.
Key Features of Trello MCP Server
- List all Trello boards
- Read board contents (lists and cards)
- Create, move, comment on, and archive cards
- Create and archive lists, update names, delete boards
- Expose boards as MCP resources (
board:{boardId}) in JSON format - Docker support for containerised deployment
- Ready‑to‑use configuration snippets for Claude Desktop and GitHub Copilot Chat
Use Cases of Trello MCP Server
- AI‑driven task management – ask an assistant to create or move cards without opening Trello.
- Voice‑controlled project tracking – integrate with speech‑enabled AI tools to update boards on the fly.
- Automation scripts – trigger MCP calls from CI/CD pipelines to keep project boards in sync.
- Team onboarding – let new members query board status via chat assistants.
FAQ
Q: Where do I get the Trello API credentials? A: Visit https://trello.com/app-key, copy the API key, then generate a token using the "Token" link on the same page.
Q: Do I need to rebuild after changing the code?
A: Yes. Run npm run build (or rebuild the Docker image) to compile the latest TypeScript changes.
Q: How do I stop the server?
A: Press Ctrl+C in the terminal where the server is running.
Q: Can I run the server without Docker?
A: Absolutely. After building, start it with node dist/index.js and provide the required environment variables.
Q: What permissions does the Trello token need? A: The token must have read/write access to the boards you intend to manage. Grant full read/write scope when generating the token.
Q: Is the server secure?
A: Credentials are injected via environment variables and never stored in the repository. Keep .env files out of version control and rotate keys regularly.
Trello MCP Server's README
Trello MCP Server
A Model Context Protocol (MCP) server that connects Trello with AI assistants like Claude Desktop, GitHub Copilot Chat, and other MCP-compatible clients.
Features
- 📋 List all your Trello boards
- 🔍 Read board contents (lists and cards)
- ➕ Create new cards
- 🔄 Move cards between lists
- 💬 Add comments to cards
- 🗃️ Archive cards
- 🔗 Access boards as MCP resources
- 🐳 Docker support for easy deployment
Prerequisites
- Node.js 20+ installed (for local development)
- Docker (for containerized deployment)
- A Trello account
- Trello API credentials (API Key and Token)
Installation
Option 1: Local Installation
- Clone this repository:
git clone https://github.com/lioarce01/trello-mcp-server.git
cd trello-mcp-server
- Install dependencies:
npm install
- Build the TypeScript code:
npm run build
Option 2: Docker Installation
- Clone this repository:
git clone https://github.com/lioarce01/trello-mcp-server.git
cd trello-mcp-server
- Build the Docker image:
docker build -t trello-mcp-server .
Getting Trello API Credentials
-
Get your API Key:
- Go to https://trello.com/app-key
- Copy your API Key
-
Get your Token:
- On the same page, click on "Token" link
- Authorize the application and copy your Token
Configuration
For Claude Desktop
Local Installation
Add the server configuration to your Claude Desktop config file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json
{
"mcp": {
"servers": {
"trello-mcp": {
"command": "node",
"args": ["absolute/path/to/the/project/dist/index.js"],
"env": {
"TRELLO_API_KEY": "your_api_key",
"TRELLO_TOKEN": "your_token",
"TRELLO_BASE_URL": "https://api.trello.com/1"
}
}
}
}
}
Docker Configuration
For Docker deployment, add this configuration:
{
"mcp": {
"servers": {
"trello-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"TRELLO_API_KEY=your_api_key",
"-e",
"TRELLO_TOKEN=your_token",
"-e",
"TRELLO_BASE_URL=https://api.trello.com/1",
"trello-mcp-server"
]
}
}
}
}
For VS Code with GitHub Copilot Chat
Local Installation
Add to your VS Code settings.json:
{
"mcp": {
"servers": {
"trello-mcp": {
"command": "node",
"args": ["absolute/path/to/the/project/dist/index.js"],
"env": {
"TRELLO_API_KEY": "your_api_key",
"TRELLO_TOKEN": "your_token",
"TRELLO_BASE_URL": "https://api.trello.com/1"
}
}
}
}
}
Docker Configuration
{
"mcp": {
"servers": {
"trello-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"TRELLO_API_KEY=your_api_key",
"-e",
"TRELLO_TOKEN=your_token",
"-e",
"TRELLO_BASE_URL=https://api.trello.com/1",
"trello-mcp-server"
]
}
}
}
}
Important:
- Replace
absolute/path/to/the/project/dist/index.jswith the actual absolute path to your compiled server file (local installation) - Replace
YOUR_TRELLO_API_KEYandYOUR_TRELLO_TOKENwith your actual Trello credentials
Docker Usage
Using Docker Run
# Build the image
docker build -t trello-mcp-server .
# Run with API key and token as arguments
docker run --rm -i --env-file .env trello-mcp-server
Local Testing
To test if your server works correctly:
- Build the project:
npm run build
- Run with credentials:
node dist/index.js
Docker Testing
- Build and run with Docker:
docker build -t trello-mcp-server .
docker run --rm -i --env-file .env trello-mcp-server
- You should see:
MCP server connected and ready.
Note: The server will wait for MCP client connections. To exit, press Ctrl+C.
Once configured, you can interact with your Trello boards through natural language:
List Boards
Show me all my Trello boards
Read Board Contents
What cards are in my "Project Management" board?
Create Cards
Create a new card called "Review documentation" in the "To Do" list
Move Cards
Move the "Bug fix" card to the "In Progress" list
Add Comments
Add a comment to the card saying "This needs urgent attention"
Archive Cards
Archive the completed card "Setup database"
Available Tools
| Tool | Description | Parameters |
|---|---|---|
list_boards |
List all open Trello boards | None |
read_board |
Read lists and cards from a specific board | boardId |
create_list |
Create a list | boardId, name |
create_card |
Create a new card in a specific list | listId, name, desc (optional) |
move_card |
Move a card to a different list | cardId, listId |
add_comment |
Add a comment to a card | cardId, text |
archive_card |
Archive a card | cardId |
archive_list |
Archive a list | listId |
delete_board |
Delete a board | boardId |
update_list_name |
Update a list name | listId, name |
update_card_name |
Update a card name | cardId, name |
Available Resources
The server exposes your Trello boards as MCP resources that can be read by AI assistants:
- Resource URI:
board:{boardId} - Content: JSON containing all lists and cards for the board
Development
Building
Local Development
npm run build
Docker Development
# Build Docker image
docker build -t trello-mcp-server .
Running in Development
Local Development
To run the server directly (for testing):
# With npm
npm run build
node dist/index.js
# With pnpm
pnpm run build
node dist/index.js
Docker Development
# Run with docker (pass credentials as arguments)
docker run --rm -i --env-file .env trello-mcp-server
Development Scripts
You can also create a development script in your package.json:
{
"scripts": {
"build": "tsc",
"start": "node dist/index.js",
"dev": "tsx ./src/index.ts",
"docker:build": "docker build -t trello-mcp-server .",
"docker:run": "docker run --rm -i --env-file .env trello-mcp-server"
}
}
Troubleshooting
Server Not Connecting
- Check credentials: Make sure you're passing API Key and Token as arguments
- Verify file path: Ensure the path in your MCP configuration is correct (local installation)
- Build first: Always run
npm run buildordocker buildbefore testing - Test standalone: Try running the server independently first
- Restart client: Restart your MCP client (Claude Desktop/VS Code) after config changes
Docker-Specific Issues
- Image not found: Make sure you've built the Docker image first with
docker build -t trello-mcp-server . - Arguments not passed: Ensure API key and token are passed as arguments after the image name
- Permissions: Check that Docker has the necessary permissions to run containers
Invalid Credentials Error
- Double-check your Trello API Key and Token
- Ensure the token has the necessary permissions
- Try regenerating your token if it's expired
- Verify credentials are properly passed as arguments
Tools Not Working
- Verify the board/card/list IDs are correct
- Check that you have write permissions to the Trello board
- Look at the console logs for detailed error messages
Security Notes
- Never commit your API credentials to version control
- Store credentials securely and rotate them regularly
- Use
.envfiles and add them to.gitignore - The server only requires the permissions you grant via the Trello token
- Consider using environment variables for credentials in production
- Docker containers run with non-root user for security
License
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ for the MCP community
Trello MCP Server Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Trello MCP Server's Information
- Author
- lioarce01
- Category
- Workflow & Automation
- Language
- TypeScript
- License
- MIT License
- Version
- v1.0.0
- Stars
- 3
- Updated
- 21 days ago
Configuration
{
"mcpServers": {
"trello-mcp": {
"command": "npx",
"args": [
"-y",
"trello-mcp-server"
],
"env": {
"TRELLO_API_KEY": "<YOUR_TRELLO_API_KEY>",
"TRELLO_TOKEN": "<YOUR_TRELLO_TOKEN>",
"TRELLO_BASE_URL": "https://api.trello.com/1"
}
}
}
}Configure Clients
Similar MCP Servers like Trello MCP Server
Explore related MCPs that share similar capabilities and solve comparable challenges
Skyvern
Officialby Skyvern-AI
Automates browser‑based workflows by leveraging large language models and computer‑vision techniques, turning natural‑language prompts into fully functional web interactions without writing custom scripts.
BlenderMCP
Officialby ahujasid
Enables Claude AI to control Blender for prompt‑assisted 3D modeling, scene creation, and manipulation via a socket‑based Model Context Protocol server.
Pipedream
by PipedreamHQ
Connect APIs quickly with a free, hosted integration platform that enables event‑driven automations across 1,000+ services and supports custom code in Node.js, Python, Go, or Bash.
Inbox Zero
by elie222
Organizes email inbox, drafts replies in the user's tone, tracks follow‑ups, and provides analytics to achieve inbox zero quickly.
Cursor Talk To Figma
by grab
Enables Cursor AI to read and programmatically modify Figma designs through a Model Context Protocol integration.
Ableton MCP
by ahujasid
Enables Claude AI to control Ableton Live in real time, allowing AI‑driven creation, editing, and playback of tracks, clips, instruments, and effects through a socket‑based server.
N8n Mcp Server
by leonardsellem
Provides tools and resources to enable AI assistants to manage and execute n8n workflows via natural language commands.
Gmail AutoAuth MCP Server
by GongRzhe
Provides a Model Context Protocol server that enables AI assistants to send, read, search, and organize Gmail messages, supporting attachments, label and filter management, and automatic OAuth2 authentication.
Flujo
Clientby mario-andreschak
A unified platform that manages AI models, MCP servers, and complex workflows, offering secure key storage, visual flow building, and an interactive chat UI.