DEV Community

Ramandeep Singh
Ramandeep Singh

Posted on

Created an MCP Server for Trello (100% Open Source) πŸš€

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 βš™οΈ

  1. πŸ§‘β€πŸ’» Clone the repository:
git clone https://github.com/r123singh/trello-mcp-server.git
Enter fullscreen mode Exit fullscreen mode
  1. πŸ“‚ cd trello-mcp-server
  2. πŸ—οΈ Create a virtual environment:
python -m venv venv
Enter fullscreen mode Exit fullscreen mode
  1. ▢️ Activate the virtual environment:
source venv/bin/activate
Enter fullscreen mode Exit fullscreen mode
  1. πŸ“¦ Install dependencies:
pip install -r requirements.txt
Enter fullscreen mode Exit fullscreen mode
  1. πŸ” Configure your environment variables: Create a .env file with:
TRELLO_API_KEY=your_trello_api_key
TRELLO_API_TOKEN=your_trello_token
Enter fullscreen mode Exit fullscreen mode
  1. πŸ› οΈ 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"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Replace:

  • πŸ—‚οΈ {{PATH_TO_DIRECTORY}} with the absolute path to this directory (use pwd command)
  • πŸ”‘ Add your API keys and tokens

To get Trello credentials:

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 πŸ’»

  1. Open MCP settings in Cursor AI - File -> Settings -> MCP -> Enable MCP
  2. 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"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode
  1. πŸ”„ Restart Cursor AI

  2. Use the following prompt to use the trello mcp server:

I need to create a new card named "Project planning" in Trello. πŸƒ
Enter fullscreen mode Exit fullscreen mode

Cursor Agent


Claude Desktop πŸ–₯️

  1. Open Claude Desktop. Go to File -> Settings -> Select developer tab -> Click on "Edit config"
  2. It will open location of config file in your default editor. It is named 'claude_desktop_config.json'. Open it.
  3. 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"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode
  1. The new mcp server should appear in the settings page with status "Running" or "Connected" βœ…

  2. 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.

Tools Trello

  1. Use the following prompt to create a new card:
I need to create a new card named "Sprint planning" in Trello. πŸƒ
Enter fullscreen mode Exit fullscreen mode
  1. 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. πŸ”—

Trello Workspace

New Project card

  1. You can now use the card id to update the card or move it to a different list.

Heroku

Built for developers, by developers.

Whether you're building a simple prototype or a business-critical product, Heroku's fully-managed platform gives you the simplest path to delivering apps quickly β€” using the tools and languages you already love!

Learn More

Top comments (0)

ACI image

ACI.dev: Fully Open-source AI Agent Tool-Use Infra (Composio Alternative)

100% open-source tool-use platform (backend, dev portal, integration library, SDK/MCP) that connects your AI agents to 600+ tools with multi-tenant auth, granular permissions, and access through direct function calling or a unified MCP server.

Check out our GitHub!