Cursor and VS Code Integration

Time tracking fails when it means switching windows. Adding the Timesheet MCP server to your editor lets the assistant you already use start the timer, log what you finished, and pull a report, all inside the editor.

What you can ask for

• "Start the timer for this repository's project"
• "Stop the timer and note that I finished the migration"
• "How long have I spent on this project this week?"
• "Log 90 minutes on the refactor for yesterday afternoon"

Before you start

• A Timesheet Pro plan or above. See plans and pricing.
• A Timesheet API key from the web app under Integrations > API Keys.
• Node.js 18 or higher, so the server can run through npx.

Cursor

Open Cursor Settings > Features > MCP Servers and add:

{
  "timesheet": {
    "command": "npx",
    "args": ["@timesheet/mcp"],
    "env": {
      "TIMESHEET_API_TOKEN": "your-api-token-here"
    }
  }
}

VS Code with Continue

Install the Continue extension, then add the server to its configuration:

{
  "mcpServers": [
    {
      "name": "timesheet",
      "command": "npx",
      "args": ["@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "your-api-token-here"
      }
    }
  ]
}

Other editors

Any editor or client that supports the Model Context Protocol can run the same server. The command is npx @timesheet/mcp with TIMESHEET_API_TOKEN in the environment. For a global install, run npm install -g @timesheet/mcp and use timesheet-mcp as the command instead.

Troubleshooting

• Nothing responds, or authentication fails. Check that TIMESHEET_API_TOKEN has no extra spaces or quotes, and that the key still exists under Integrations > API Keys.
• Command not found. Confirm Node.js 18 or higher with node --version. If npx cannot find the package, install it globally.
• A timer will not start. Make sure the project name matches an existing project you have access to. Ask "What's my timer status?" to test the connection on its own.

Good to know

Your API key grants full access to your account, so keep it out of anything you commit. To revoke access, delete the key under Integrations > API Keys and remove the server from your editor configuration.