Linear

ClockMe + Linear

Linear is the issue tracker of choice for modern dev teams. ClockMe connects to Linear through your AI coding workflow: when you start a Claude Code or Cursor session on a Linear issue, ClockMe's MCP auto-starts the timer and you can log the Linear issue ID in the entry description. A native Linear OAuth integration — syncing issues as ClockMe tasks and auto-tracking on assignment — is coming.

Get started free →Setup guide ↓

What gets automated

→Timer starts automatically when you open a coding session on a Linear issue
→Log Linear issue IDs in entry descriptions via natural language
→Query hours per project (Linear team) without leaving your editor
→Budget alerts when a Linear team is close to its weekly hour limit
→Coming soon: OAuth sync — Linear issues become ClockMe tasks automatically

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 Linear

Create a ClockMe account

Create ClockMe projects to mirror your Linear teams

Create one ClockMe project per Linear team or client. Set the billing rate.

Add MCP + hook config

Add the ClockMe MCP server and SessionStart / SessionEnd / UserPromptSubmit hooks to ~/.claude/settings.json. Replace ck_live_YOUR_KEY with your key. Directory-name fuzzy-match picks the right project — or creates one named after the folder if it's new; UserPromptSubmit pings a heartbeat each turn; SessionEnd stops the timer.

Reference Linear issues in your timer entries

Tell your AI: 'I am starting work on LIN-142 — add that to the timer description.' ClockMe logs the issue ID against the time entry.

~/.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": "p=$(basename \"$CLAUDE_PROJECT_DIR\"); if [ -z \"$p\" ] || [ \"$p\" = \"$(basename \"$HOME\")\" ]; then exit 0; fi; b=$(git -C \"$CLAUDE_PROJECT_DIR\" branch --show-current 2>/dev/null | tr -d '\"\\\\'); 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\\\":\\\"$p\\\",\\\"branch\\\":\\\"$b\\\",\\\"autoCreate\\\":true,\\\"source\\\":\\\"hook\\\",\\\"description\\\":\\\"Claude Code session\\\"}\" > /dev/null",
            "shell": "bash"
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "p=$(basename \"$CLAUDE_PROJECT_DIR\"); if [ -z \"$p\" ] || [ \"$p\" = \"$(basename \"$HOME\")\" ]; then exit 0; fi; 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\\\":\\\"$p\\\"}\" > /dev/null",
            "shell": "bash"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "p=$(basename \"$CLAUDE_PROJECT_DIR\"); if [ -z \"$p\" ] || [ \"$p\" = \"$(basename \"$HOME\")\" ]; then exit 0; fi; b=$(git -C \"$CLAUDE_PROJECT_DIR\" branch --show-current 2>/dev/null | tr -d '\"\\\\'); 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 \"{\\\"projectName\\\":\\\"$p\\\",\\\"branch\\\":\\\"$b\\\"}\" > /dev/null",
            "shell": "bash"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "p=$(basename \"$CLAUDE_PROJECT_DIR\"); if [ -z \"$p\" ] || [ \"$p\" = \"$(basename \"$HOME\")\" ]; then exit 0; fi; b=$(git -C \"$CLAUDE_PROJECT_DIR\" branch --show-current 2>/dev/null | tr -d '\"\\\\'); 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 \"{\\\"projectName\\\":\\\"$p\\\",\\\"branch\\\":\\\"$b\\\"}\" > /dev/null",
            "shell": "bash"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "p=$(basename \"$CLAUDE_PROJECT_DIR\"); if [ -z \"$p\" ] || [ \"$p\" = \"$(basename \"$HOME\")\" ]; then exit 0; fi; f=\"$HOME/.claude/.cm_beat_$p\"; now=$(date +%s); last=$(cat \"$f\" 2>/dev/null || echo 0); [ $((now-last)) -lt 60 ] && exit 0; echo \"$now\" > \"$f\"; b=$(git -C \"$CLAUDE_PROJECT_DIR\" branch --show-current 2>/dev/null | tr -d '\"\\\\'); 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 \"{\\\"projectName\\\":\\\"$p\\\",\\\"branch\\\":\\\"$b\\\"}\" > /dev/null",
            "shell": "bash"
          }
        ]
      }
    ]
  }
}

Natural language commands

Ask in plain English

You: “Start a timer for LIN-142: Refactor billing API”

ClockMe: Timer started on Platform project. Description: LIN-142 — refactor billing API.

You: “How long have I worked on the Platform project this sprint?”

ClockMe: 22.5h on Platform project in the last 14 days.

You: “Stop my timer — I'm moving this issue to review”

ClockMe: Timer stopped. 1h 45m logged on Platform. LIN-142 total: 4h 10m this week.

You: “What issues have I been working on today?”

ClockMe: Today: LIN-142 (2h 15m), LIN-138 (1h 30m). Total: 3h 45m on Platform.

FAQ

Linear integration questions

Does ClockMe have a native Linear integration?

A native Linear OAuth integration is on the ClockMe roadmap. It will sync Linear issues as ClockMe tasks and optionally start timers when issues are assigned to you. Today, the MCP + Claude Code hook approach is the recommended workflow.

Can ClockMe tasks mirror Linear issues?

Not automatically yet, but you can create ClockMe tasks manually to mirror your Linear issues and log time at the task level. When the native Linear integration ships, this sync will be automatic.

How do I track time across multiple Linear teams?

Create one ClockMe project per Linear team. Use concurrent timers if you switch between teams in the same day. Each ClockMe project can have its own billing rate and budget.

Does this work with Linear's Cycles (sprints)?

You can align ClockMe's reporting date ranges with your Linear cycle dates to see hours per cycle. Native cycle-sync is part of the Linear integration roadmap.

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

Use ClockMe while you work on GitHub issues — then let the native integration handle the rest.

Notion