MCP Server

Trackee includes a local Model Context Protocol (MCP) server. It communicates with an AI client through standard input and standard output.

Current tool

The tool calls GET /health. It does not read or change organization data.

Start Trackee

Start the API:

pnpm --filter @trackee/api dev

In a second terminal, start the MCP server:

TRACKEE_API_URL=http://localhost:3001 \
  pnpm --filter @trackee/mcp dev

Connect an AI client

Build the MCP package:

pnpm --filter @trackee/mcp build

Add this stdio server entry to the AI client's MCP configuration. Replace the example repository path with the absolute path on your computer.

{
  "mcpServers": {
    "trackee": {
      "command": "node",
      "args": ["/absolute/path/to/trackee/apps/mcp/dist/index.js"],
      "env": {
        "TRACKEE_API_URL": "http://localhost:3001"
      }
    }
  }
}

Restart the AI client after you save the configuration.

Test the connection

Ask the AI client:

Check whether the Trackee API is healthy.

A healthy response contains:

{
  "service": "api",
  "status": "ok"
}