GitHub / Microsoft

ClockMe + GitHub

GitHub is where your code, issues, and pull requests live. ClockMe is where your billable hours live. Today, the fastest way to connect them is via ClockMe's MCP server in Claude Code or Cursor: start a coding session on a GitHub issue and the timer starts automatically. A native GitHub App with webhook-based tracking — start timer on issue assign, stop on PR merge — is on the ClockMe roadmap.

Get started free →Setup guide ↓

What gets automated

→Timer starts when you open a Claude Code session to work on GitHub issues
→Ask your AI to log the GitHub issue number in the time entry description
→Stop timer automatically when you close the session or push your branch
→Query hours spent on a GitHub project without leaving your editor
→Coming soon: native GitHub App with webhook-based timer start/stop on issue events

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 GitHub

Create a ClockMe account

Create a project per GitHub repo (or client)

In ClockMe, create a project for the repository or client you are billing.

Add MCP + hook config to Claude Code

Open ~/.claude/settings.json and add the MCP server config plus the SessionStart / SessionEnd / UserPromptSubmit hooks. Replace ck_live_YOUR_KEY with your key. The start hook auto-matches the repo folder name to a ClockMe project (creating one named after the folder if it's new), UserPromptSubmit pings a heartbeat each turn, and SessionEnd stops the timer.

Tell your AI what issue you are working on

Once in a session, say: 'I am working on GitHub issue #42 — start a timer on the API project with that description.' ClockMe logs the issue reference in the entry description.

~/.claude/settings.jsonJSON

{
  "mcpServers": {
    "clockme": {
      "type": "http",
      "url": "https://clockme.co/api/mcp",
      "headers": {
        "Authorization": "Bearer ck_live_YOUR_KEY"
      }
    }
  },
  "hooks": {
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "curl -sf --max-time 10 -X POST https://clockme.co/api/timer/start -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d \"{\\\"projectName\\\":\\\"$(basename \"$CLAUDE_PROJECT_DIR\")\\\",\\\"autoCreate\\\":true,\\\"source\\\":\\\"hook\\\",\\\"description\\\":\\\"Claude Code session\\\"}\" > /dev/null",
            "shell": "bash"
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "curl -sf --max-time 10 -X POST https://clockme.co/api/timer/stop -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d \"{\\\"projectName\\\":\\\"$(basename \"$CLAUDE_PROJECT_DIR\")\\\"}\" > /dev/null",
            "shell": "bash"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "curl -sf --max-time 10 -X POST https://clockme.co/api/timer/heartbeat -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d '{}' > /dev/null",
            "shell": "bash"
          }
        ]
      }
    ]
  }
}

Natural language commands

Ask in plain English

You: “Start a timer for GitHub issue #47 — refactor auth middleware”

ClockMe: Timer started on API project. Description: GitHub issue #47 — refactor auth middleware.

You: “How long have I spent on this issue?”

ClockMe: Current entry: 1h 22m on API project. Session started at 10:14am.

You: “I'm opening a PR — stop the timer and log the total”

ClockMe: Timer stopped. 2h 48m logged on API project. Entry saved.

You: “How many hours did I bill on this repo this week?”

ClockMe: 14.5h logged on API project this week (Mon–Sun). $1,450 at $100/hr.

FAQ

GitHub integration questions

Does ClockMe have a GitHub App I can install?

A native GitHub App with webhook-based tracking is on the ClockMe roadmap. It will allow timers to start automatically when an issue is assigned to you and stop when you open a pull request. Today, the MCP + Claude Code hook approach is the fastest setup.

Can I link a ClockMe time entry to a specific GitHub issue?

You can include the issue number in the entry description — either manually or by asking your AI to add it. When the native GitHub integration ships, entries will automatically reference issue numbers.

Can I track time on open source GitHub repos (no client billing)?

Yes. Create a project in ClockMe even if it has no billing rate. You can track time for personal visibility and contribution stats without generating invoices.

Does ClockMe work in GitHub Codespaces?

Yes. Codespaces runs VS Code in the browser and supports MCP via the .vscode/mcp.json config. Add the ClockMe MCP config and use GitHub Copilot Chat in agent mode to control your timer from within a Codespace.

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.

Linear

Track time on Linear issues without leaving your AI coding tool.

Notion