trello-mcp-server

# Trello MCP Server A Model Context Protocol (MCP) server that provides tools for interacting with the Trello API. Credentials are stored securely in your OS credential manager, not in plaintext files. ## Features - **Secure Credential Storage**: Credentials stored in OS credential manager (Windows Credential Manager, macOS Keychain, or Linux libsecret) - **No Plaintext Secrets**: No `.env` files, no environment variables for credentials - **Trello Integration**: Complete access to Trello boards, lists, cards, and more - **Comprehensive API Coverage**: Support for all major Trello operations - **Type Safety**: Full TypeScript support with proper typing for Trello objects - **Error Handling**: Robust error management throughout the codebase ## Getting Started ### Prerequisites - Node.js 18 or higher - npm - Trello API key and token (see below) **Linux only**: Install libsecret ```bash # Debian/Ubuntu sudo apt install libsecret-1-dev # Fedora sudo dnf install libsecret-devel # Arch sudo pacman -S libsecret ``` ### Installation 1. Clone this repository: ```bash git clone https://github.com/v4lheru/trello-mcp-server.git cd trello-mcp-server ``` 2. Install dependencies: ```bash npm install ``` 3. Build the project: ```bash npm run build ``` 4. **Set up your credentials securely**: ```bash npm run setup-credentials ``` This will prompt you for your Trello API key and token, then store them in your OS credential manager. **To get your credentials:** 1. Go to https://trello.com/app-key 2. Copy your API Key 3. Click "Generate a Token" and copy the token ### Usage Start the MCP server: ```bash npm start ``` ### Migrating from .env Files If you have existing credentials in a `.env` file, the setup script will automatically detect them: ```bash npm run setup-credentials ``` You'll see: ``` 📁 Found existing credentials in: /path/to/.env Both API Key and Token found. Migrate these credentials to secure storage? (Y/n): ``` After migration, you can optionally remove the credentials from your `.env` file. ### Managing Credentials - **Set/update credentials**: `npm run setup-credentials` - **Delete credentials**: `npm run delete-credentials` Credentials are stored in: - **Windows**: Credential Manager → Windows Credentials → `trello-mcp-server` - **macOS**: Keychain Access → `trello-mcp-server` - **Linux**: GNOME Keyring / KDE Wallet → `trello-mcp-server` ## Claude Desktop Configuration Add to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "trello": { "command": "node", "args": ["C:/path/to/trello-mcp-server/build/index.js"] } } } ``` ## Available Tools ### Board Tools - `get_boards` - Get all boards for the authenticated user - `get_board` - Get a specific board by ID - `create_board` - Create a new board - `update_board` - Update an existing board - `delete_board` - Delete a board - `get_board_lists` - Get all lists on a board - `get_board_members` - Get all members of a board - `get_board_labels` - Get all labels on a board - `close_board` - Close (archive) a board - `reopen_board` - Reopen a closed board ### List Tools - `get_list` - Get a specific list by ID - `create_list` - Create a new list on a board - `update_list` - Update an existing list - `archive_list` - Archive a list - `unarchive_list` - Unarchive a list - `move_list_to_board` - Move a list to a different board - `get_cards_in_list` - Get all cards in a list - `archive_all_cards` - Archive all cards in a list - `move_all_cards` - Move all cards in a list to another list ### Card Tools - `get_card` - Get a specific card by ID - `create_card` - Create a new card - `update_card` - Update an existing card - `delete_card` - Delete a card - `archive_card` - Archive a card - `move_card_to_list` - Move a card to a different list - `add_comment` - Add a comment to a card - `get_comments` - Get comments on a card - `add_attachment` - Add an attachment to a card - `get_attachments` - Get attachments on a card - `set_due_date` - Set the due date for a card - `set_due_complete` - Mark a card's due date as complete ### Member Tools - `get_me` - Get the authenticated member (current user) - `get_member` - Get a specific member by ID or username - `get_member_boards` - Get boards that a member belongs to - `get_member_cards` - Get cards assigned to a member - `search_members` - Search for members by name ### Label Tools - `get_label` - Get a specific label by ID - `create_label` - Create a new label on a board - `update_label` - Update an existing label - `delete_label` - Delete a label - `add_label_to_card` - Add a label to a card - `remove_label_from_card` - Remove a label from a card ### Checklist Tools - `get_checklist` - Get a specific checklist by ID - `create_checklist` - Create a new checklist on a card - `update_checklist` - Update an existing checklist - `delete_checklist` - Delete a checklist - `get_checkitems` - Get all checkitems on a checklist - `create_checkitem` - Create a new checkitem on a checklist - `update_checkitem` - Update a checkitem on a checklist - `delete_checkitem` - Delete a checkitem from a checklist ## Security Credentials are stored in your OS credential manager (Windows Credential Manager, macOS Keychain, or Linux libsecret) and encrypted using your login credentials. ## License This project is licensed under the MIT License.