Marko (Hermes Implementer)
034ed2c928
Add 12 card management tools: - trello_create_card — create a card on a list - trello_card_details — view card with members, checklists, comments - trello_update_card — update title, description, due date - trello_move_card — move card to a different list - trello_archive_card — archive a card - trello_assign_member / trello_remove_member — member management - trello_add_comment / trello_delete_comment — comments - trello_add_checklist_item / trello_toggle_checklist_item / trello_delete_checklist_item Also adds _delete() helper on TrelloClient for DELETE verbs. 73 total tests — all passing. Issue: #4
trello-plugin
Hermes Agent plugin for Trello board integration.
Setup
1. Get Trello Credentials
- Get your API Key from: https://trello.com/app-key
- Generate a Token from the same page (click "Token" under API Key)
- Set these as environment variables in your Hermes profile config (
.envorconfig.yaml):
export TRELLO_API_KEY="your-trello-api-key"
export TRELLO_TOKEN="your-trello-token"
2. Install
cd trello-plugin
pip install .
For development:
pip install -e ".[dev]"
3. Register with Hermes Agent
Add the plugin to your Hermes config (~/.hermes/config.yaml or profile):
plugins:
- trello-plugin
Available Tools
Once configured, the agent has access to these tools:
trello_verify_credentials
Verifies your Trello API key and token are valid by calling the Trello API.
✓ Trello credentials verified successfully (authenticated as your-username)
trello_list_boards
Lists all Trello boards accessible with your credentials.
| Field | Description |
|---|---|
id |
Trello board ID |
name |
Board name |
url |
Direct Trello URL |
closed |
Whether the board is archived |
starred |
Whether the board is starred |
trello_disconnect
Clears Trello credentials from the in-memory client. Since credentials are stored in environment variables, the agent can reconnect automatically on the next tool call.
Development
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
PYTHONPATH=src python3 -m pytest tests/ -v
# Lint
pip install ruff
ruff check src/
Architecture
trello-plugin/
├── src/
│ └── trello_plugin/
│ ├── __init__.py # Package exports
│ ├── client.py # TrelloClient — REST API wrapper
│ └── tools.py # Hermes tool definitions
├── tests/
│ └── test_auth.py # Test suite (18 tests)
├── docs/
│ └── backend/
│ └── trello-auth-spec.md
├── pyproject.toml
└── README.md