Calq MCP

What it does

Calq MCP connects your AI assistant to a self-hosted time tracking and project management backend. You can start/stop timers, log hours, manage clients and projects, capture memories with semantic recall, and get invoice-ready unbilled time summaries — all through natural language. Teams can collaborate with GitHub OAuth authentication and role-based access control.

Tools

Time Tracking

• commit — Log time with a message, project, and optional date
• start / stop — Real-time timer start and stop
• timer_status — Check if a timer is running
• cancel_timer — Discard a running timer
• edit / delete — Modify or remove entries

Summaries & Billing

• get_today_summary — Time logged today by project
• get_weekly_summary — This week's time broken down by day
• get_unbilled — All unbilled time across projects
• get_invoice_summary — Unbilled time grouped by client with calculated values
• list_projects / list_projects_detailed — Project overview with totals

AI Memory

• remember / recall — Store and semantically search personal or shared notes
• idea — Quick-capture an idea
• search_entries — Semantically search past time entries
• forget — Delete a stored memory

Clients, Projects & Users

• add_client / list_clients — Manage client records
• configure_project — Create/update projects with client and hourly rate
• whoami / list_users / team_summary — User and team management

Installation

Requires Docker, PostgreSQL, ChromaDB, a Voyage AI API key, and a GitHub OAuth App.

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "calq": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Start the server with Docker Compose:

git clone https://github.com/Calq-dev/calq-mcp.git && cd calq-mcp
cp .env.example .env  # add your API keys
docker compose up -d

Supported hosts

Claude Desktop is the confirmed primary client (HTTP transport via url field in config).