Trello MCP Server

A Model Context Protocol (MCP) server for integrating Trello with AI assistants. This server exposes Trello API functionality via MCP tools that AI agents can use.

Prerequisites

• Node.js (see .nvmrc for version)
• pnpm (recommended) or npm
• Trello API key and token

Setup

1. Clone the repository

git clone <repository-url>
cd trello-mcp-server

2. Install dependencies

pnpm install
# or
npm install

3. Set up environment variables

cp .env.example .env 

Required environment variables:

• TRELLO_API_KEY: Your Trello API key
• TRELLO_TOKEN: Your Trello API token
• TRELLO_BASE_API_URL: Trello API base URL (default: https://api.trello.com/1)

You can obtain your Trello API key and token from Trello's Developer Portal.

Development

Start the development server with auto-reload:

pnpm dev
# or
npm run dev

Build

Build the project:

pnpm build
# or
npm run build

Usage

Start the server:

pnpm start
# or
npm start

Available MCP Tools

• get_trello_cards_by_board_id: Retrieve all cards from a specific Trello board
  • Parameters:
    • boardId: The ID of the Trello board

Adding New Tools

To add a new Trello API tool, follow these steps:

1. Add a new API method in src/services/trelloApi.ts
2. Register the tool in src/index.ts using the server.tool() method
3. Define the input schema using Zod
4. Implement the tool handler function

License

ISC