claude-mcp-trello

claude-mcp-trello

5
cloud_platforms

Claude MCP Trello is a Model Context Protocol server designed for seamless integration with Trello boards, offering robust error handling and type-safe features. The project aims to simplify board interactions through a set of comprehensive tools with automated rate limiting and error messaging. It uses TypeScript and integrates with Claude Desktop for enhanced usability.

Claude MCP Trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server enables seamless integration with Trello's API while handling rate limiting, type safety, and error handling automatically.

Features

  • Full Trello Board Integration: Interact with cards, lists, and board activities
  • Built-in Rate Limiting: Respects Trello's API limits
  • Type-Safe Implementation: Written in TypeScript with comprehensive type definitions
  • Input Validation: Robust validation for all API inputs
  • Error Handling: Graceful error handling with informative messages

Available Tools

  • trello_get_cards_by_list: Retrieves a list of cards contained in the specified list ID.
  • trello_get_lists: Retrieves all lists in the board.
  • trello_get_recent_activity: Retrieves the most recent board activity.
  • trello_add_card: Adds a card to the specified list.
  • trello_update_card: Updates the content of a card.
  • trello_archive_card: Archives the specified card.
  • trello_add_list: Adds a new list to the board.
  • trello_archive_list: Archives the specified list.
  • trello_get_my_cards: Retrieves all cards related to your account.
  • trello_search_all_boards: Performs a cross-board search across all boards.

Rate Limiting

The server uses a token bucket algorithm for rate limiting to comply with Trello's API limits.

Error Handling

The server provides detailed error messages for various scenarios such as invalid input parameters and network issues.

Development

Prerequisites

  • Node.js 16 or higher
  • npm or yarn

Setup

  1. Clone the repository and install dependencies.
  2. Build the project.

Running Tests

Provides a command for running tests.

Integration with Claude Desktop

Instructions on integrating the MCP server with Claude Desktop are provided.

Contributing

Contributions are welcome, and the guide is available for details.

License

This project is licensed under the MIT License.