Trello MCP Server
MCP server for the Trello REST API – manage boards, lists, cards, labels, checklists and more
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
trello-mcpclaude mcp add trello-mcp-server -e 'TRELLO_API_KEY=<your trello_api_key>' -e 'TRELLO_TOKEN=<your trello_token>' -- uvx trello-mcp==1.6.0
{
"mcpServers": {
"trello-mcp-server": {
"command": "uvx",
"args": [
"trello-mcp==1.6.0"
],
"env": {
"TRELLO_API_KEY": "<your trello_api_key>",
"TRELLO_TOKEN": "<your trello_token>"
}
}
}
}
متغيرات البيئة
TRELLO_API_KEYإلزامي سري API key from Trello Power-Up admin (https://trello.com/power-ups/admin)TRELLO_TOKENإلزامي سري User token generated for your Trello API key
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Trello MCP Server
An MCP server for the Trello REST API. Manage boards, lists, cards, labels, checklists, and more from any MCP-compatible client.
Tools
| Tool | Description |
|---|---|
list_my_boards | List all boards for the authenticated user |
get_board | Get details of a single board |
get_board_lists | Get all lists on a board |
create_list | Create a new list on a board |
get_list_cards | Get all cards in a list |
get_board_cards | Get all cards on a board |
get_card | Get details of a single card |
create_card | Create a new card in a list |
update_card | Update one or more fields on a card |
move_card | Move a card to a different list/board |
archive_card | Archive (close) a card |
get_card_comments | Get all comments on a card |
add_card_comment | Add a comment to a card |
get_card_attachments | Get all attachments on a card |
add_card_attachment | Upload a file as an attachment to a card |
add_card_url_attachment | Attach a URL to a card |
delete_card_attachment | Delete an attachment from a card |
get_board_labels | Get all labels on a board |
create_label | Create a label on a board |
get_card_checklists | Get all checklists on a card |
get_checklist | Get a checklist and its items |
create_checklist | Create a checklist on a card |
add_checklist_item | Add an item to a checklist |
get_me | Get the authenticated member's profile |
search_trello | Search for cards and/or boards |
get_card_history | Get the action history of a card (moves, edits, comments, etc.) |
Prerequisites
- Go to trello.com/power-ups/admin and create a new Power-Up
- Copy your API Key
- Generate a Token using the link on the same page
Installation
uvx trello-mcp
Or install from PyPI:
pip install trello-mcp
Usage
Claude Desktop / Claude Code
Add to your .mcp.json:
{
"mcpServers": {
"trello": {
"command": "uvx",
"args": ["trello-mcp"],
"env": {
"TRELLO_API_KEY": "your-api-key",
"TRELLO_TOKEN": "your-token"
}
}
}
}
Environment Variables
| Variable | Required | Description |
|---|---|---|
TRELLO_API_KEY | Yes | API key from Trello Power-Up admin |
TRELLO_TOKEN | Yes | User token generated for your API key |
Development
git clone https://github.com/stucchi/trello-mcp.git
cd trello-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest
License
MIT
الأسئلة الشائعة
ما هو Trello MCP Server؟
MCP server for the Trello REST API – manage boards, lists, cards, labels, checklists and more
كيف أثبّت Trello MCP Server؟
يعمل على جهازك. في Claude Code: claude mcp add trello-mcp-server -e 'TRELLO_API_KEY=<your trello_api_key>' -e 'TRELLO_TOKEN=<your trello_token>' -- uvx trello-mcp==1.6.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Trello MCP Server إلى مفتاح API؟
نعم. يتطلب TRELLO_API_KEY, TRELLO_TOKEN، وتضبطها في إعداداته.
هل Trello MCP Server مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Trello MCP Server؟
ينشره stucchi. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.