Cursor, Windsurf & VS Code

IDE-based AI tools that support MCP connect to WhoWorked via the hosted MCP server with OAuth — no API keys. The config shape differs slightly per tool, so use the matching snippet below.

Cursor

Open Cursor Settings → Tools & Integrations (MCP).
Click New MCP server and add WhoWorked with the URL below, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "whoworked": {
      "url": "https://mcp.whoworked.com/mcp"
    }
  }
}

Fully restart Cursor (quit and reopen), then complete the OAuth sign-in the first time you use a WhoWorked tool.

Windsurf

Windsurf configures MCP through ~/.codeium/windsurf/mcp_config.json. Note that Windsurf uses the serverUrl key for remote servers (not url):

{
  "mcpServers": {
    "whoworked": {
      "serverUrl": "https://mcp.whoworked.com/mcp"
    }
  }
}

You can also add it from the Cascade panel: click the MCP tools icon → Manage MCP servers → Add server. Refresh the list, then complete the OAuth sign-in.

VS Code (GitHub Copilot)

VS Code connects MCP servers through Copilot's agent mode.

Open the Command Palette (Cmd/Ctrl + Shift + P) and run MCP: Add Server.
Choose HTTP and enter https://mcp.whoworked.com/mcp — or create .vscode/mcp.json. Note VS Code uses a top-level servers map with an explicit transport type:

{
  "servers": {
    "whoworked": {
      "type": "http",
      "url": "https://mcp.whoworked.com/mcp"
    }
  }
}

Start the server from the MCP view and complete the OAuth sign-in in your browser.
Switch Copilot Chat to Agent mode to use the WhoWorked tools.

Claude Code (CLI)

If you use Claude Code in the terminal, add the server with one command:

claude mcp add whoworked --transport http https://mcp.whoworked.com/mcp

What to expect

Once connected, your AI coding assistant can:

Start a timer when you begin a task
Stop the timer when you're done
Log a work session summary with token usage
Look up project details for context