Diegofornalha MCP Server Trello

🚀 MCP Server Trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server seamlessly integrates with the Trello API while handling rate limits, type safety, and error handling.

✨ Features

• Full Trello Board Integration: Interact with cards, lists, and board activities.
• Built-in Rate Limiting: Respect Trello's API limits (300 requests per API key per 10 seconds, 100 requests per token per 10 seconds).
• Type-safe Implementation: Written in TypeScript with comprehensive type definitions.
• Input Validation: Robust validation for all API inputs.
• Error Handling: Graceful error handling and detailed error messages.

📦 Installation

npm install @modelcontextprotocol/mcp-server-trello

📚 Configuration

Add the server to your MCP settings file as follows:

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token",
        "TRELLO_BOARD_ID": "your-board-id"
      }
    }
  }
}

Required Environment Variables

• TRELLO_API_KEY: Your Trello API key (obtained from https://trello.com/app-key).
• TRELLO_TOKEN: Your Trello token (generated using the API key).
• TRELLO_BOARD_ID: The ID of the Trello board to interact with (found in the board URL).

💻 Usage Examples

Basic Usage

get_cards_by_list_id

Get all cards by list ID.

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // List ID
  }
}

get_lists

Retrieve all lists in the configured board.

{
  name: 'get_lists',
  arguments: {}
}

get_recent_activity

Get recent activity on the board.

{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // Optional: Number of activities to fetch (default: 10)
  }
}

add_card_to_list

Add a new card to a specified list.

{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // ID of the list to add the card to
    name: string,         // Card name
    description?: string, // Optional: Card description
    due?: Date,          // Optional: Due date
    labels?: string[]     // Optional: Array of label IDs
  }
}

add_comment_to_card

Add a comment to a specified card.

{
  name: 'add_comment_to_card',
  arguments: {
    cardId: string, // Card ID
    text: string     // Comment text
  }
}

🔧 Technical Details

Rate Limiting

By default, the free tier of the Trello API is limited to:

• 20 requests per minute
• 1000 requests per hour

If you need higher rate limits, consider upgrading to a paid plan.

Error Handling

All API calls return an object with the following fields:

{
  success: boolean,       // A boolean indicating whether the operation was successful
  data?: any,           // Response data on success
  error?: {
    message: string      // Error message
  }
}

🛠️ Development

Clone the Repository

git clone https://github.com/modelcontextprotocol/server-trello.git
cd server-trello

Install Dependencies

npm install

Build the Project

npm run build

Run Tests

npm test

🤝 Contribution

Contributions are welcome! Please read our Contribution Guidelines to understand the code standards and the process for submitting pull requests.

📄 License

This project is distributed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built using the modelcontextprotocol SDK.
• Utilizes the Trello REST API.