Timesheet

io.github.timesheetIOPublished by GitHub account timesheetIOv2.0.2Updated Oct 25, 2026

timesheet.io MCP server - manage timers, projects, tasks and reports

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & Analytics

Overview

AI-generated overview

Timesheet MCP server lets an AI assistant control timesheet.io: run timers, log work, pull statistics and exports, and manage projects, absences and teams.

What you can do
Start, pause, resume, stop and edit the running timer, and log past work as time entries with notes, expenses and breaks, including updating or deleting entries. Pull statistics such as totals, billable hours and per-project or daily breakdowns, and produce Excel, CSV and PDF exports and document PDFs. Manage projects, members, todos, tags and rates. Request, approve and cancel time off, and manage absence types and contracts. Handle team and organization members and invitations, and see who is tracking time now. View and update the account profile and settings.
When to use it
Useful when you already track time in timesheet.io and want to drive it by chat instead of the web app: starting timers, backfilling hours, checking billable totals, exporting reports, or filing time off.
Requirements
Either the hosted endpoint with a Timesheet account sign-in (OAuth) or an API key, or the local npm package run with npx, which needs Node.js 20 or higher and the TIMESHEET_API_TOKEN environment variable. A Timesheet Pro plan or above is required for API access.
Before you install
The API token grants access to your timesheet account; keep it out of shared configs. The server can create, update and delete time entries and projects, request or approve absences, and change team membership, so review write actions before confirming. Exports can be emailed to recipients. When running the local HTTP server, leave TIMESHEET_API_TOKEN unset if it can be reached from outside your computer.

Installation

In SourceWeft

  1. Open Timesheet in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.timesheetIO%2Ftimesheet-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

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

README

Timesheet MCP Server

[npm version] [License: MIT] [Node.js Version] [MCP Compatible]

Control Timesheet with natural language from AI assistants such as ChatGPT, Claude, Claude Code, Cursor, and VS Code. Start and stop timers, log past work, pull statistics and exports, request time off, and manage projects and teams by chatting.

The server supports the current version of the Model Context Protocol (2026-07-28) and the earlier ones, so it works with new and older clients alike. The full guide is at docs.timesheet.io.

Two ways to connect

Hosted serverLocal server
Addresshttps://mcp.timesheet.ioRuns on your computer with npx -y @timesheet/mcp
Sign-inYour Timesheet account (OAuth 2.1), or an API keyAn API key
RequirementsNoneNode.js 20 or higher

Both offer the same tools. You need a Timesheet Pro plan or above, which includes API access.

Get an API key

In the Timesheet web app, go to Integrations > API Keys, select New API Key, and copy the key. The same key works for the hosted server, the local server, and the Timesheet API.

Use the hosted server

ChatGPT: turn on developer mode, add a connection with the URL https://mcp.timesheet.io, and sign in with your Timesheet account when asked.

Claude Code with an API key:

bash
claude mcp add --transport http --scope user timesheet https://mcp.timesheet.io --header "Authorization: Bearer your-api-token-here"

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

json
{  "mcpServers": {    "timesheet": {      "url": "https://mcp.timesheet.io",      "headers": { "Authorization": "Bearer your-api-token-here" }    }  }}

Use the local server

Claude Code:

bash
claude mcp add timesheet --scope user -e TIMESHEET_API_TOKEN=your-api-token-here -- npx -y @timesheet/mcp

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows), and other clients with the same format:

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

Restart the client after you change its configuration. The guide has the setup for VS Code and other clients.

Example prompts

  • "Start the timer for the website project"
  • "Pause my timer, I'm taking lunch", then "Stop the timer"
  • "Log 2 hours on the API project for Monday"
  • "What did I work on yesterday?"
  • "How many billable hours did I track in September?"
  • "Email the September timesheet for Acme as a PDF to [email protected]"
  • "Book me off next Friday"
  • "Who on my team is tracking right now?"

Tools

The server offers more than 100 tools. The assistant picks the right ones, so you do not need to name them.

AreaWhat the tools do
TimerStart, pause, resume, stop, and edit the running timer
Time entriesList, create, update, and delete entries, and add notes, expenses, and breaks
StatisticsTotals, billable hours, and per-project and daily breakdowns for up to a year
Reports and exportsExcel, CSV, and PDF exports, export templates, and PDFs of documents, tasks, expenses, and notes
Projects, todos, and tagsManage projects and their members, todos, tags, and rates
Time off and contractsRequest, approve, and cancel absences, and manage absence types and contracts
Teams and organizationsManage members and invitations, and see who is tracking time right now
AccountView and update your profile and settings

The guide lists every tool.

Interactive cards

In clients that support MCP Apps, such as ChatGPT and Claude, the timer, new and changed time entries, statistics, exports, and absence requests appear as interactive cards. They follow the client's light or dark theme and language. Other clients show the same information as text.

Development

bash
npm installnpm run build       # server and widgetsnpm test            # unit testsnpm run test:e2e    # both protocol versions over stdio and HTTP, against the buildnpm run dev         # HTTP server on http://127.0.0.1:3000

The HTTP server uses TIMESHEET_API_TOKEN for requests that bring no credentials, so leave it unset whenever the server can be reached from outside your computer. See .env.example for the other settings.

Troubleshooting

  • Nothing responds, or you get an authentication error: check that TIMESHEET_API_TOKEN is set without extra spaces or quotes, and that the key still exists in Integrations > API Keys.
  • The command is not found: check that Node.js 20 or higher is installed with node --version.
  • A tool reports that it needs a higher plan: the MCP server works with a Pro plan or above.

License

MIT, see LICENSE.md.

Support

Report problems and ideas at github.com/timesheetIO/timesheet-mcp/issues.

Source: README.md at commit 48394cb

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

4
  1. v2.0.2LatestSep 27, 2026
  2. v2.0.1Sep 27, 2026
  3. v2.0.0Sep 27, 2026
  4. v1.0.5Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts