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.ioAdd to Settings → Connectors → Add custom connector
https://mcp.timesheet.ioAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"timesheet-mcp": {
"url": "https://mcp.timesheet.io"
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media