mcp -ts-trello

This MCP server implements a Trello integration using TypeScript. It exposes a set of tools that allow AI assistants or clients to interact with Trello boards, lists, and cards in a structured, type-safe way. The available tools include get_boards to list the authenticated user’s boards, get_lists to retrieve lists from a specified board, get_cards to fetch cards from a board or a specific list, and get_card_details to obtain detailed information about a particular card. To use these tools, ensure your environment provides Trello API credentials (API key and token) and that the MCP server is running with those credentials available via environment variables. The tooling is designed for asynchronous operation and includes error handling for authentication issues, rate limits, and invalid parameters.

Prerequisites:

• Node.js 18.x or higher
• npm or yarn
• Trello API credentials (API key and token)

Installation steps:

1. Install dependencies and build the project (as per the repository's Makefile):

make install

2. Create a .env file in the project root with your Trello credentials:

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

3. Build the project (if required by the workflow):

make build

4. Start the MCP server:

make start

5. Validate the server is running and accessible by invoking one of the MCP tools via your client or by checking server logs.

Tips and caveats:

• Ensure your Trello API key and token have the necessary permissions for the boards you intend to access.
• Store credentials securely; avoid committing .env files to version control.
• If you encounter authentication errors, double-check that the environment variables are loaded correctly by the process.
• The server is designed for asynchronous Trello operations; consider surrounding calls with appropriate timeout and retries for network variability.
• If you customize paths, update the build output path used in the MCP configuration (build/index.js in the example).
• When integrating with Cline or other MCP clients, provide the same command and arguments as shown in the example configuration to ensure compatibility.