Codeium

ClockMe + Windsurf

Windsurf by Codeium is an agentic AI editor with a Cascade AI assistant that supports MCP natively. ClockMe connects to Windsurf's Cascade via the standard HTTP MCP protocol with Bearer token authentication. Once set up, you can ask Cascade to start, stop, and report on your time in natural language without leaving your editor.

Get started free →Setup guide ↓

What gets automated

→Ask Cascade to track time without switching apps or tabs
→Natural language timer control inside your editor
→Hourly and project summaries on demand
→Budget burn tracking — know when you are approaching your limit
→Stop all active timers at end of day with one Cascade command

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 Windsurf

Create a ClockMe account

Get your API key

ClockMe Settings, then API Keys, then Generate. Name it Windsurf. Copy the key on creation.

Edit Windsurf MCP config

Open Windsurf Settings, then Cascade, then MCP Servers, or edit the config file directly. Add the clockme entry and save.

Ask Cascade

Open a Cascade chat and type: start a timer on my client project. Cascade calls ClockMe's MCP tools and the clock is running.

~/.codeium/windsurf/mcp_config.jsonJSON

{
  "mcpServers": {
    "clockme": {
      "serverUrl": "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 backend API project”

ClockMe: Timer started on Backend API. Running.

You: “How many hours this week?”

ClockMe: 22.5h logged this week. Backend API: 14h. Client portal: 8.5h.

You: “Stop the timer and add a note: fixed auth flow”

ClockMe: Timer stopped. 2h 18m logged on Backend API with note: fixed auth flow.

You: “Am I close to my project budget?”

ClockMe: Backend API: 58h logged of 80h budget (72%). ~22h remaining.

FAQ

Windsurf integration questions

Which Windsurf version added MCP support?

Windsurf added MCP support in a 2024 update. If you do not see the MCP Servers section in Cascade settings, update Windsurf to the latest version.

Does Windsurf use the same MCP format as Claude Code?

The protocol is the same (Model Context Protocol), but the config file format differs slightly. Windsurf uses serverUrl instead of url, and the config lives in ~/.codeium/windsurf/mcp_config.json rather than ~/.claude/settings.json.

Can I use both Windsurf and another MCP client simultaneously?

Yes. Multiple MCP clients can connect to ClockMe simultaneously with the same or different API keys. Each client has its own key for auditability.

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.

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.

Linear