AnythingMCP Cloud is live — 7-day free trial−30% for 3 months with START30
AnythingMCP
Connector guide3-minute read9 MCP tools7 languages

Connect Kimai to Gemini CLI via MCP: Time Tracking

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

HCBy HelpCode teamUpdated 3 min read Open-source on GitHub
Install Kimai on Cloud — free trialRead the step-by-step guide

No credit card · 7-day trial · Self-host alternative available

Kimai

Kimai

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

tools

9

Region

DE

Category

Time Tracking

Authentication

Bearer Token

Required env vars

KIMAI_URLKIMAI_API_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

Guided setup

Connect Kimai to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Kimai in the guided setup, then add your MCP URL to Gemini. No code and no server to run.

Set up Kimai freeI already have an account

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Kimai

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Kimai · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Kimai, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Kimai + Gemini

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

KIMAI_URL, KIMAI_API_TOKEN

Step 1 — Get credentials

Getting a token (Kimai 2.x)

  1. Sign in to your Kimai instance, open your user profile and go to the API tab.
  2. Create an API token and copy it into KIMAI_API_TOKEN. Kimai 2.x uses a bearer token here; the older X-AUTH-USER/X-AUTH-TOKEN header pair from Kimai 1.x is deprecated and is not what this adapter sends.
  3. Set KIMAI_URL to the base URL of your instance without a trailing slash and without /api, e.g. https://time.example.com. The adapter appends /api.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
  2. Save the file and restart gemini.
  3. Run /mcp inside the Gemini CLI — Kimai should be listed as available.
  4. Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID to the tools array of your request with the same X-API-Key header.

Available tools

ToolWhat it does
kimai_get_versionRead the Kimai version and copyright of the connected instance
kimai_list_timesheetsRead timesheet entries in a date range with their project, activity, duration, rate and billable flag
kimai_get_active_timesheetsRead the entries that are running right now for the authenticated user — Kimai's live clock, answering 'am I still tracking something'
kimai_list_customersList customers with their number, country, currency and visible flag
kimai_list_projectsList projects, optionally for one customer, with their budget, time budget and start and end dates
kimai_list_activitiesList activities — the task types time is booked against — either global or attached to one project
kimai_list_usersList Kimai users with their username, alias, e-mail and roles
kimai_create_timesheetBook a timesheet entry against a project and activity
kimai_stop_timesheetStop a running timesheet entry, setting its end to now

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.

Next steps

Was this guide helpful?

Connect Kimai to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Kimai in the guided setup, then add your MCP URL to Gemini. No code and no server to run.

Set up Kimai freeSelf-host with DockerContact Sales

Related guides

Connectors

Connect Kimai to Microsoft Copilot via MCP

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

Connectors

Connect Kimai to Meta Muse via MCP: Time Tracking

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

Connectors

Connect Kimai to ChatGPT via MCP: Timesheets and Timers

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

Connectors

Connect Kimai to Claude via MCP: Timesheets and Timers

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

Connectors

Connect Kimai to Cursor via MCP: Timesheets and Projects

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.

Connectors

Kimai MCP Server: Timesheets, Projects and Timers

Kimai — the self-hosted open-source time tracker. Read and create timesheets, browse customers, projects, activities and users, and check the running clock. REST API v1 on your own Kimai instance, bearer API token.