Overview π
I've built a local MCP Server for Trello that's completely open source! This innovative server leverages the Model Context Protocol (MCP) to create a seamless bridge between your applications and Trello. Get ready to supercharge your workflow with these amazing capabilities:
- π Managing boards and viewing their details
- ποΈ Working with lists and cards
- π Creating and updating cards
- π Moving cards between lists
- π¬ Adding comments to cards
- π₯ Managing board members
To get started, you'll need:
Setup βοΈ
- π§βπ» Clone the repository:
git clone https://github.com/r123singh/trello-mcp-server.git
- π cd trello-mcp-server
- ποΈ Create a virtual environment:
python -m venv venv
- βΆοΈ Activate the virtual environment:
source venv/bin/activate
- π¦ Install dependencies:
pip install -r requirements.txt
- π Configure your environment variables:
Create a
.env
file with:
TRELLO_API_KEY=your_trello_api_key
TRELLO_API_TOKEN=your_trello_token
- π οΈ Configure MCP JSON:
Create a
mcp.json
file with:
{
"mcpServers": {
"trello": {
"command": "{PATH_TO_DIRECTORY}\\trello-mcp-server\\venv\\Scripts\\python.exe",
"args": [
"{PATH_TO_DIRECTORY}\\trello-mcp-server\\server.py"
],
"env": {
"TRELLO_API_KEY": "your_trello_api_key",
"TRELLO_API_TOKEN": "your_trello_token"
}
}
}
}
Replace:
- ποΈ
{{PATH_TO_DIRECTORY}}
with the absolute path to this directory (usepwd
command) - π Add your API keys and tokens
To get Trello credentials:
- π Go to https://trello.com/app-key
- π Copy the API Key
- π Generate a token by visiting: https://trello.com/1/authorize?expiration=never&scope=read,write,account&response_type=token&name=Server%20Token&key=YOUR_API_KEY
- (replace YOUR_API_KEY with your actual API key)
- π Replace your_trello_api_key and your_trello_token in the config with these value
Available Tools π οΈ
The server provides the following tools for interacting with Trello:
- π Get all boards
- π Get board details
- ποΈ Get lists in a board
- π Get cards in a list
- π Get card details
- π Create new cards
- βοΈ Update existing cards
- π Move cards between lists
- π¬ Add comments to cards
- π₯ Get board members
Usage π¦
Now that you have the MCP server configured, you can use it in your applications. The server provides a natural language interface to interact with Trello through the available tools such as Cursor, Claude Desktop
Cursor AI π»
- Open MCP settings in Cursor AI - File -> Settings -> MCP -> Enable MCP
- Add the following to your Cursor AI settings:
{
"mcpServers": {
"trello": {
"command": "{PATH_TO_DIRECTORY}\\trello-mcp-server\\venv\\Scripts\\python.exe",
"args": [
"{PATH_TO_DIRECTORY}\\trello-mcp-server\\server.py"
],
"env": {
"TRELLO_API_KEY": "your_trello_api_key",
"TRELLO_API_TOKEN": "your_trello_token"
}
}
}
}
π Restart Cursor AI
Use the following prompt to use the trello mcp server:
I need to create a new card named "Project planning" in Trello. π
Claude Desktop π₯οΈ
- Open Claude Desktop. Go to File -> Settings -> Select developer tab -> Click on "Edit config"
- It will open location of config file in your default editor. It is named 'claude_desktop_config.json'. Open it.
- Add the following to the config:
{
"mcpServers": {
"trello": {
"command": "{PATH_TO_DIRECTORY}\\trello-mcp-server\\venv\\Scripts\\python.exe",
"args": [
"{PATH_TO_DIRECTORY}\\trello-mcp-server\\server.py"
],
"env": {
"TRELLO_API_KEY": "your_trello_api_key",
"TRELLO_API_TOKEN": "your_trello_token"
}
}
}
}
The new mcp server should appear in the settings page with status "Running" or "Connected" β
Close the settings page and go back to the chat. Select the 3 line icon just below the chat input box. It should display now "trello" in the list of available servers, clicking it will list all the tools available.
- Use the following prompt to create a new card:
I need to create a new card named "Sprint planning" in Trello. π
- It will prompt initially to run the tool. Click on "Always run". It will create the card in Trello and return the link to the new card. π
- You can now use the card id to update the card or move it to a different list.
Top comments (0)