# Timesheet

> Timesheet is a paid MCP server for productivity. Run timesheet.io timers, entries, reports and time off by chatting with an AI assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI, Web
- **Website:** https://mcp.timesheet.io
- **Repository:** https://github.com/timesheetio/timesheet-mcp
- **MCP Registry name:** io.github.timesheetIO/timesheet-mcp
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.timesheet.io
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "timesheet-mcp": {
      "url": "https://mcp.timesheet.io"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/timesheet
