Claude Desktop Integration

Claude can control your time tracking through the Model Context Protocol. Once connected, you describe what you did and Claude records it: no forms, no switching to another app.

What you can ask for

• "Start the timer for the website project"
• "Pause my timer, I'm taking lunch"
• "Add a $45 expense for lunch with the client"
• "Show me this week's time entries"
• "How many hours did I bill to Acme last month?"

Before you start

• A Timesheet Pro plan or above. See plans and pricing.
• Claude Desktop installed, or an account on claude.ai.

Option 1: the hosted connector

The quickest route, and there is nothing to install. Add a custom connector in Claude and point it at:

https://mcp.timesheet.io

Claude sends you to Timesheet to sign in and approve access, then the tools appear in your conversation. Authorisation uses OAuth, so no API key is stored in your client configuration.

Option 2: run the server locally

Prefer to keep everything on your own machine? Create an API key in the web app under Integrations > API Keys, then edit the Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

This needs Node.js 18 or higher, so the server can run through npx. Restart Claude Desktop, then ask "What's my timer status?" to confirm the connection.

What Claude can reach

The server exposes 50 tools, grouped as:

• Timer: start, stop, pause, resume, status, update
• Tasks: create, update, delete, list, plus notes, expenses, and breaks on the running task
• Projects: create, update, delete, list, and details
• Reports and exports: documents, task and expense reports, PDF output, Excel and CSV exports, and saved export templates
• Absences: request, approve, reject, cancel, and list, along with absence types
• Statistics: summaries over any period

Good to know

• The server can read and create time entries, manage projects, and add notes, expenses, and breaks. It cannot reach other users' private data or change your billing.
• With the local option, your API key grants full access to your account. Never share it or commit it to version control.
• To revoke access, delete the API key under Integrations > API Keys and remove the server from your client configuration.