How it works

The MCP server runs locally as a background process. When you ask your AI agent to log time, it calls list_projects to find the right project and task, then add_time_entry to record the entry. Your timesheet updates in real time.

Step 1 — Create an API key

Click your avatar in the top-right corner to open the Account Portal, then go to API Keys and create a new key. Copy it — you will need it in the next step.

Fullscreen

Step 2a — Claude Desktop

Add the following to your claude_desktop_config.json file, then restart Claude Desktop.

{
  "mcpServers": {
    "timesheetai": {
      "command": "npx",
      "args": ["-y", "@timesheetai/mcp@alpha"],
      "env": {
        "TIMESHEETAI_API_KEY": "ak_..."
      }
    }
  }
}

Verify your setup

Open Claude Desktop, go to File → Settings → Developer. You should see timesheetai listed with a status of running. If it shows an error, double-check your API key and restart Claude Desktop.

Fullscreen

Step 2b — Claude Code (CLI)

Run the following command in your terminal. The server will be available immediately in your current Claude Code session.

claude mcp add timesheetai \
  --env TIMESHEETAI_API_KEY=ak_... \
  -- npx -y @timesheetai/mcp@alpha

Verify by typing /mcp inside Claude Code — timesheetai should appear with a connected status.