chronos-mcp

An MCP (Model Context Protocol) server for Chronos Trello time tracking. Lets AI assistants log and retrieve worklogs on Trello cards via the Chronos API.

Tools

save_worklog

Save a worklog entry for a Trello card.

| Parameter | Type | Required | Description | | ------------ | ------ | -------- | ------------------------------------------------ | | boardId | string | yes | Trello board ID | | cardId | string | yes | Trello card ID | | seconds | number | yes | Time spent in seconds | | startedAt | string | yes | ISO 8601 date-time (e.g. 2026-03-10T10:00:00.000Z) | | comment | string | no | Description of work done |

get_worklogs

Get worklogs for a Trello card.

| Parameter | Type | Required | Description | | --------- | ------ | -------- | -------------- | | cardId | string | yes | Trello card ID |

Setup

Prerequisites

• Bun runtime
• A Chronos API token (JWT)

Install

bun install

Getting your Chronos token

1. Open Chronos in your browser
2. Open DevTools (F12) and go to the Network tab
3. Save a worklog on any Trello card
4. Find the saveWorklog request in the network log
5. In the request headers, copy the value after Bearer in the Authorization header

Environment variables

| Variable | Default | Description | | ------------------ | ---------------------------------- | ---------------------- | | CHRONOS_TOKEN | — | Your Chronos JWT token | | CHRONOS_API_BASE | https://api.chronos.it-pal.net | Chronos API base URL |

Configure in Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "chronos": {
      "command": "bunx",
      "args": ["chronos-trello-mcp"],
      "env": {
        "CHRONOS_TOKEN": "your-jwt-token"
      }
    }
  }
}

Run standalone

CHRONOS_TOKEN=your-jwt-token bunx chronos-trello-mcp

The server communicates over stdio using the MCP protocol.