Timebook MCP Server
Command-line client and MCP server for Timebook - track time, manage timers, and expose your Timebook account to AI agents (Claude, Codex, Cursor, …) over the Model Context Protocol. Its 10 documented tools cluster into read & search, timer, entry, whoami.
People who work with timer and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-06-08 · ★ 2 · #685 OF 945 MAINTAINED OTHER · VERIFIED 2026-09-18
MIT · TypeScript servers · how we verify → /methodology
01 · Install Timebook
before you install - you'll need
Set TIMEBOOK_API_URL, TIMEBOOK_WEB_URL before connecting.
Claude Code
claude mcp add squidcode-timebook-cli --transport http https://usetimebook.com/mcpClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"squidcode-timebook-cli": {
"url": "https://usetimebook.com/mcp"
}
}
}Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
https://usetimebook.com/mcp
transport: streamable-http
endpoint alive - authentication required · probed 2026-09-17
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to usetimebook.com
endpoint auth requires authentication - rejected our unauthenticated MCP initialize
license MIT - declared in the repository
npm package @squidcode/timebook - published under the repo owner's npm scope (@squidcode)
registry namespace io.github.squidcode is GitHub-verified and matches the repo owner
03 · What Timebook can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can start a timer on a project, stop the running timer, log a manual entry (duration OR startTime+endTime), and edit one or more fields on an entry (description, duration, startTime, endTime, project, rate). Token must own the entry.
Capability map
Tools grouped from the project's README - what Timebook lets an agent do.
read & search
3 tools - e.g. All projects in scope (read-only); All clients in scope (read-only); Recent entries (default 50, max 500), project + date filters
list_projects · list_clients · list_entries
Timer
3 tools - e.g. The running timer, or null (read-only); Start a timer on a project; Stop the running timer
get_active_timer · start_timer · stop_timer
Entry
2 tools - e.g. Edit one or more fields on an entry (description, duration, startTime, endTime, project, rate). Token must own the entry.; Delete an entry. Token must own it. Invoiced entries are locked.
update_entry · delete_entry
Whoami
1 tool - e.g. Current authenticated user (read-only)
whoami
Log
1 tool - e.g. Log a manual entry (duration OR startTime+endTime)
log_time
Latest releases
v0.6.0 · 2026-06-05
0.6.0 (2026-06-05) · cold-start hints + create_client/create_project tools
v0.5.0 · 2026-05-10
0.5.0 (2026-05-10) · advertise the hosted /mcp endpoint via server.json remotes
v0.4.0 · 2026-05-10
0.4.0 (2026-05-10) · add display title + favicon to server.json so directories show a real listing
04 · Who maintains Timebook
Timebook is maintained by squidcode. We track 2 MCP servers from squidcode - 1 actively maintained, 2 combined GitHub stars, oldest repo from May 2026.
05 · Facts
- repository
- github.com/squidcode/timebook-cli
- website
- https://usetimebook.com/
- category
- other - ranked #685 of 945 actively-maintained other servers as of 2026-09-18.
- registry
- io.github.squidcode/timebook (active, first published 2026-05-04 · 6 versions)
- packages
- npm:@squidcode/timebook
06 · Timebook FAQ
Is Timebook still maintained?
Yes - as of 2026-09-18, its last commit was 2026-06-08. We re-verify nightly.
What can Timebook do?
With this server connected, an agent can start a timer on a project, stop the running timer, log a manual entry (duration OR startTime+endTime), and edit one or more fields on an entry (description, duration, startTime, endTime, project, rate). Token must own the entry.
How do I install Timebook?
Run `npx -y @squidcode/timebook`. The README documents 2 environment variables (TIMEBOOK_API_URL, TIMEBOOK_WEB_URL) to set first. Set TIMEBOOK_API_URL, TIMEBOOK_WEB_URL before connecting. You can also paste the ready-made client config above.
Does Timebook require authentication?
Yes - when we probed the endpoint on 2026-09-17, it rejected an unauthenticated MCP initialize; you'll need credentials to connect.
07 · Alternatives to Timebook
Alternatives to Timebook
Maintained other servers if Timebook isn't the fit.
- Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,552 · 2026-09-17
- Server Commands An MCP server to run arbitrary commands ★ 39,038 · 2026-09-11
- basebalance.cloud - x402 RPC & MCP gateway USDC-gated Base JSON-RPC: free 10 req/min, $0.50 per 10k. Failover, cache, /mcp, ledger. ★ 6,432 · 2026-08-26
- Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 5,069 · 2026-09-15
- Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,470 · 2026-09-18
- Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,681 · 2026-09-17
More MCP servers to compare · Dev Track · Agent Booster · Stack Overflow MCP Server · SEC EDGAR Filings MCP · Inav MCP
More TypeScript MCP servers · Squirrelscan · Diffgate · Mobile Device MCP · Agy Bridge · Openrouter Multimodal · see all