Trello MCP Server (TypeScript)
A TypeScript implementation of a Model Context Protocol (MCP) server for Trello integration, providing tools for AI assistants to interact with Trello boards, lists, and cards.
Features
- Full Trello API integration through MCP tools
- Asynchronous operations for better performance
- Type-safe implementation using TypeScript
- Comprehensive error handling
- Environment-based configuration
Prerequisites
- Node.js 18.x or higher
- npm or yarn
- Trello API credentials
Installation
# Install dependencies
make install
Configuration
Create a .env file in the root directory with your Trello credentials:
TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token
Available Commands
# Install dependencies
make install
# Build the project
make build
# Start the server
make start
# Clean build artifacts
make clean
# Run linter
make lint
MCP Tools
get_boards
Retrieves all Trello boards for the authenticated user.
// No input parameters required
get_lists
Fetches all lists from a specified board.
{
"request": {
"board_id": string // ID of the board
}
}
get_cards
Gets cards from a board or specific list.
{
"request": {
"board_id": string, // ID of the board
"list_id"?: string // Optional: ID of a specific list
}
}
get_card_details
Retrieves detailed information about a specific card.
{
"request": {
"card_id": string // ID of the card
}
}
Development
The project uses TypeScript for type safety and better developer experience. The source code is organized as follows:
src/index.ts- Main server entry pointsrc/trello-client.ts- Trello API client implementationsrc/types.ts- TypeScript type definitions
Building
The project uses TypeScript compiler for building:
# Build the project
make build
# The output will be in the build/ directory
Error Handling
The server implements comprehensive error handling for:
- API authentication errors
- Rate limiting
- Network issues
- Invalid request parameters
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Using with Cline
To use this MCP server with Cline, add the following configuration to your Cline MCP settings file (~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):
{
"mcpServers": {
"trello-ts": {
"command": "node",
"args": ["/path/to/mcp-server-ts-trello/build/index.js"],
"env": {
"TRELLO_API_KEY": "your_api_key",
"TRELLO_TOKEN": "your_token"
}
}
}
}
After adding the configuration and restarting Cline, you can use the following MCP tools:
get_boards: List all Trello boardsget_lists: Get lists from a boardget_cards: Get cards from a board or listget_card_details: Get detailed card information
License
ISC License - See LICENSE file for details