Google

ClockMe + Gemini CLI

Gemini CLI is Google's open-source terminal AI agent. It supports remote HTTP MCP servers natively, which means ClockMe plugs in with a single JSON config entry. If you work primarily in the terminal and use Gemini CLI for coding assistance, you can start timers, query hours, and manage projects without ever opening a browser.

Get started free →Setup guide ↓

What gets automated

→Full timer control from the terminal — no GUI needed
→Check hours from any shell without opening a browser
→Create and list projects from the command line
→Get billable summaries for invoicing from the terminal
→Works over SSH — track time on remote development machines

Want your key pre-filled?

Sign in to ClockMe and use the setup wizard — it generates the exact config with your real API key and project ID already embedded.

Open setup wizard →

60-second setup

How to connect Gemini CLI

Install Gemini CLI

Run `npm install -g @google/gemini-cli` and authenticate with your Google account using `gemini auth`.

Create your ClockMe API key

ClockMe Settings, then API Keys, then Generate. Name it Gemini CLI. Copy the key.

Edit ~/.gemini/settings.json

Add the clockme MCP server entry to your Gemini CLI settings file, replacing YOUR_KEY with your API key.

Ask in your terminal

Run `gemini` in any project directory and ask it to start a ClockMe timer. It will call the MCP tool and confirm.

~/.gemini/settings.jsonJSON

{
  "mcpServers": {
    "clockme": {
      "httpUrl": "https://clockme.co/api/mcp",
      "headers": {
        "Authorization": "Bearer ck_live_YOUR_KEY"
      }
    }
  }
}

Natural language commands

Ask in plain English

You: “Start tracking time on the infrastructure project”

ClockMe: Timer started on Infrastructure. Clock is running.

You: “How many hours did I work yesterday?”

ClockMe: Yesterday: 7h 30m. Infrastructure: 4h 15m. API review: 3h 15m.

You: “What is my timer status right now?”

ClockMe: Active: Infrastructure (running 1h 42m). No other active timers.

You: “Stop the timer and give me today's total”

ClockMe: Stopped Infrastructure (1h 42m). Today total: 5h 17m billable.

FAQ

Gemini CLI integration questions

Does Gemini CLI support remote MCP servers?

Yes. Gemini CLI supports remote HTTP MCP servers via the httpUrl config key. ClockMe's MCP server is a standard HTTP+SSE endpoint, fully compatible.

Can I use ClockMe with Gemini CLI on a remote server?

Yes. Since ClockMe is a remote MCP server (not a local process), it works over any network connection. As long as your remote machine can reach clockme.app, it works over SSH.

Does Gemini CLI work on Linux?

Yes. Gemini CLI is cross-platform and runs on Linux, macOS, and Windows (WSL). ClockMe's MCP integration works identically on all platforms.

More integrations

Claude Code

Open a session. The timer starts. That is it.

Cursor

Ask Cursor to start the clock. Or let it happen automatically.

Windsurf

Tell Cascade to track your time. It just works.

GitHub Copilot

VS Code Copilot Chat now has MCP. ClockMe plugs right in.

GitHub