
Official Model Context Protocol (MCP) server for Timesheet API. Control your timer with natural
Official Model Context Protocol (MCP) server for Timesheet API. Control your timer with natural language in Claude, Cursor, and other MCP-compatible clients. Track time, manage projects, and log expenses seamlessly.
·
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.
| Hosted server | Local server | |
|---|---|---|
| Address | https://mcp.timesheet.io | Runs on your computer with npx -y @timesheet/mcp |
| Sign-in | Your Timesheet account (OAuth 2.1), or an API key | An API key |
| Requirements | None | Node.js 20 or higher |
Both offer the same tools. You need a Timesheet Pro plan or above, which includes API access.
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.
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:
claude mcp add --transport http --scope user timesheet https://mcp.timesheet.io --header "Authorization: Bearer your-api-token-here"Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"timesheet": {
"url": "https://mcp.timesheet.io",
"headers": { "Authorization": "Bearer your-api-token-here" }
}
}
}Claude Code:
claude mcp add timesheet --scope user -e TIMESHEET_API_TOKEN=your-api-token-here -- npx -y @timesheet/mcpClaude 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:
{
"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.
The server offers more than 100 tools. The assistant picks the right ones, so you do not need to name them.
| Area | What the tools do |
|---|---|
| Timer | Start, pause, resume, stop, and edit the running timer |
| Time entries | List, create, update, and delete entries, and add notes, expenses, and breaks |
| Statistics | Totals, billable hours, and per-project and daily breakdowns for up to a year |
| Reports and exports | Excel, CSV, and PDF exports, export templates, and PDFs of documents, tasks, expenses, and notes |
| Projects, todos, and tags | Manage projects and their members, todos, tags, and rates |
| Time off and contracts | Request, approve, and cancel absences, and manage absence types and contracts |
| Teams and organizations | Manage members and invitations, and see who is tracking time right now |
| Account | View and update your profile and settings |
The guide lists every tool.
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.
npm install
npm run build # server and widgets
npm test # unit tests
npm run test:e2e # both protocol versions over stdio and HTTP, against the build
npm run dev # HTTP server on http://127.0.0.1:3000The 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.
TIMESHEET_API_TOKEN is set without extra spaces or quotes, and that the key still exists in Integrations > API Keys.node --version.MIT, see LICENSE.md.
Report problems and ideas at github.com/timesheetIO/timesheet-mcp/issues.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add timesheet --transport http https://mcp.timesheet.io{
"mcpServers": {
"timesheet": {
"url": "https://mcp.timesheet.io",
"headers": {
"Authorization": ""
}
}
}
}code --add-mcp '{"name":"timesheet","url":"https://mcp.timesheet.io","headers":{"Authorization":""}}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/timesheet-mcp-server to learn what the "Timesheet MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http --scope user timesheet https://mcp.timesheet.io --header "Authorization: Bearer your-api-token-here"
claude mcp add timesheet --scope user -e TIMESHEET_API_TOKEN=your-api-token-here -- npx -y @timesheet/mcpThis server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/timesheet-mcp-server)Nothing comparable is listed yet.
v1.1.0v1.1.0 - MCP Apps SDK & Recharts StatisticsRelease notesv1.0.2Bug FixesRelease notesv1.0.1Bug Fixes & ImprovementsRelease notesv1.0.0v1.0.0 - Initial ReleaseRelease notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "timesheet-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.