Claude Code Integration

Claude Code is Anthropic's coding agent for the terminal. With the Timesheet plugin installed it can start and stop timers, record the work you just finished, and answer questions about where your hours went, without you switching windows.

What you can ask for

• "Start the timer for the API project"
• "Stop the timer and add a note: fixed the login bug"
• "What did I work on yesterday?"
• "Log 2 hours on the mobile app project for Monday"
• "Export last month as Excel and send it to my accountant"

Before you start

• A Timesheet Pro plan or above. See plans and pricing.
• A Timesheet API key, created in the web app under Integrations > API Keys.
• Node.js 18 or higher.

Install the plugin

Run these two commands inside a Claude Code session:

/plugin marketplace add timesheetIO/timesheet-plugin
/plugin install timesheet@timesheet

The plugin bundles a skill that documents every @timesheet/cli command group, so Claude Code knows the exact flags and workflows instead of guessing.

Then install the CLI the plugin drives and sign in once:

npm install -g @timesheet/cli
timesheet auth login

timesheet auth login uses OAuth 2.1 with PKCE and opens a browser. For automation and CI, set an API key instead:

export TIMESHEET_API_KEY=ts_your.apikey
timesheet auth status --json

Or connect through MCP

If you would rather have Claude Code call typed tools than run shell commands, add the Timesheet MCP server to ~/.claude/settings.json:

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

Both routes reach the same account. The plugin suits shell workflows and scripted output; the MCP server suits assistants that prefer structured tool calls.

Use the skill without the plugin

The CLI ships the same skill file, so any skills-aware agent can load it:

timesheet skill path      # check where it would be written
timesheet skill install   # write it into the agent's skills directory

Good to know

• Every read command accepts --json, so output stays machine parseable. Piping to another command switches to TSV automatically.
• Exit code 3 means the session needs to authenticate again.
• Your API key grants full access to your account. Never commit it to version control. To revoke access, delete the key under Integrations > API Keys.