Model Context Protocol

AI-Powered
Time Tracking

Connect your timesheet.io account to ChatGPT, Claude, and other AI assistants. Track time, manage projects, and generate reports with natural language.

Get API Token View Documentation

Works with any MCP client

Claude
ChatGPT
Claude Code
Cursor
VS Code
Any MCP client

claude · timesheet mcp connected

Illustrative session. It runs on your own projects and hours.

Capabilities

Your whole timesheet, in plain language.

More than 100 tools cover your account, from the running timer to reports, time off and your team.

Run the timer from the chat

Start, pause, resume and stop. Add a note, a break or an expense to the running task as you go.

timer_start
timer_pause
timer_resume
timer_stop
task_add_note
task_add_pause

Fill in the gaps

Log past work, fix start and end times, and list what you did on any day.

task_create
task_update
task_list

Projects and teams

Create and archive projects, manage members, and see who is tracking right now.

project_create
project_member_add
team_member_status

Time off and contracts

Request, approve and cancel absences, and keep employment contracts up to date.

absence_create
absence_approve
contract_list

Todos, notes and expenses

Keep todos per project, attach notes to your work, and log expenses.

todo_create
note_create
expense_create

Reports without the export dialog

Totals per project and billable hours in seconds. Exports as Excel, CSV or PDF, sent straight to a client's inbox.

statistics_get
export_generate
export_send
report_task_pdf

Hosted or local

Connect to mcp.timesheet.io with your Timesheet sign-in or an API key, or run the server yourself with npx.

mcp.timesheet.io
npx @timesheet/mcp

Just ask

No commands to learn.

Say it the way you would tell a colleague. The assistant picks the right tools.

Start the timer for the website project
What did I work on yesterday?
Pause my timer, I'm taking lunch
Log 2 hours on the API project for Monday
How many billable hours did I track in September?
Add a $45 expense for lunch with the client

Show this week's time entries
Who on my team is tracking right now?
Email Acme their September timesheet as a PDF
Add a note: fixed the login bug
Book me off next Friday
Archive the old website project

Setup

Up and running in three steps.

01
Create an API key

In the web app under Integrations, API Keys. The same key works for the Timesheet API. API access comes with the Pro plan.
02
Add Timesheet to your assistant

One command in Claude Code, a short config in Claude Desktop or Cursor, or the server URL in ChatGPT.
03
Ask in plain language

Start a timer, log yesterday or pull a report. Every change shows up in the app and on the web.

Run this in your terminal with your API key:

claude mcp add timesheet -e TIMESHEET_API_TOKEN=your_api_token -- npx -y @timesheet/mcp

Add this to claude_desktop_config.json, then restart Claude:

{
  "mcpServers": {
    "timesheet": {
      "command": "npx",
      "args": ["-y", "@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "your_api_token"
      }
    }
  }
}
              
            

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "timesheet": {
      "command": "npx",
      "args": ["-y", "@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "your_api_token"
      }
    }
  }
}
              
            

Add a connector in ChatGPT settings with this URL, then sign in with your Timesheet account:

https://mcp.timesheet.io

Setup for other clients in the documentation →

Get started

Track time from the chat you already use.

Create an API key, add the server to your assistant, and ask your first question.

Get API Token Read the setup guide

API access is part of the Pro plan. New to Timesheet? Create an account.

AI-Powered Time Tracking