Skip to content
MCP server

Timesheet

Run timesheet.io timers, entries, reports and time off by chatting with an AI assistant

Pricing
Paid
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
3.2.0
Listing updated
3 days ago

About Timesheet

Timesheet is a paid MCP server for productivity. It can run locally on your machine or as a hosted remote server.

This server exposes more than 100 tools covering a timesheet.io account: the running timer, past entries, statistics, exports, projects, todos, tags, rates, absences, contracts, teams and your profile. Say something like "log 2 hours on the API project for Monday" or "email Acme their September timesheet as a PDF" and the assistant picks the tools; changes show up in the Timesheet app and on the web.

There are two ways to connect. The hosted server at mcp.timesheet.io signs in with your Timesheet account over OAuth 2.1 or an API key, and the npm package @timesheet/mcp runs locally with an API key and Node.js 20 or higher. Both offer the same tools, and the README says it speaks the 2026-07-28 MCP version and earlier ones.

API access, and therefore this server, needs a Timesheet Pro plan or above. The code is MIT-licensed according to the README badge.

Install

Run in a terminal

claude mcp add --transport http timesheet-mcp https://mcp.timesheet.io

Add to Settings → Connectors → Add custom connector

https://mcp.timesheet.io
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "timesheet-mcp": {
      "url": "https://mcp.timesheet.io"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "timesheet-mcp": {
      "type": "http",
      "url": "https://mcp.timesheet.io"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "timesheet-mcp": {
      "serverUrl": "https://mcp.timesheet.io"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "timesheet-mcp": {
      "type": "http",
      "url": "https://mcp.timesheet.io"
    }
  }
}

Configuration

  • TIMESHEET_API_TOKENYour timesheet.io API tokenRequired

Tools this server provides (22)

Taken from the project documentation; the running server may differ.

timer_start
Starts the timer.
timer_pause
Pauses the running timer.
timer_resume
Resumes a paused timer.
timer_stop
Stops the timer.
task_add_note
Adds a note to the running task.
task_add_pause
Adds a break to a task.
task_create
Creates a time entry.
task_update
Updates a time entry.
task_list
Lists time entries.
project_create
Creates a project.
project_member_add
Adds a member to a project.
team_member_status
Shows who on the team is tracking now.
absence_create
Requests time off.
absence_approve
Approves an absence.
contract_list
Lists employment contracts.
todo_create
Creates a todo.
note_create
Creates a note.
expense_create
Logs an expense.
statistics_get
Returns totals and billable hours.
export_generate
Generates an Excel, CSV or PDF export.
export_send
Sends an export by email.
report_task_pdf
Creates a PDF report of tasks.

What it does

Timer control
Start, pause, resume and stop, with notes, breaks and expenses added to the running task.
Back-filled entries
Create, edit, list and delete past time entries.
Statistics and exports
Billable totals and per-project breakdowns, with Excel, CSV and PDF exports sent to a client.
Time off and contracts
Request, approve and cancel absences and manage contracts.
Projects and teams
Manage projects, members, todos, tags and see who is tracking now.
Hosted or local
Use mcp.timesheet.io or run the npm package yourself.

Good for

  • Start and stop a project timer from chat
  • Log forgotten hours for a past day
  • Email a client a monthly timesheet PDF
  • Ask who on the team is currently tracking time
  • Request time off by sentence

Pricing

Paid

Requires a Timesheet Pro plan or above (API access); prices not published here

Prices change. Check mcp.timesheet.io before you buy.

Timesheet FAQ

What plan do I need?

A Timesheet Pro plan or above, because it includes API access.

How do I sign in?

The hosted server uses your Timesheet account via OAuth 2.1 or an API key; the local server uses an API key.

Which clients work?

The site lists Claude, ChatGPT, Claude Code, Cursor, VS Code and any MCP client.

How many tools are there?

More than 100, grouped by timer, entries, statistics, reports, projects, time off, teams and account.

Is Timesheet free?

No. Timesheet is a paid product.

How do I add Timesheet to Claude Code?

Run this command in your terminal: claude mcp add --transport http timesheet-mcp https://mcp.timesheet.io

What are the best alternatives to Timesheet?

The closest alternatives to Timesheet are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Timesheet

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media