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 cover timer, entry.
People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-06-08 · ★ 2 · #473 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25
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-08-25
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 #473 of 848 actively-maintained other servers as of 2026-08-25.
- release cadence
- 1 release in the last 90 days (latest 2026-06-05)
- 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-08-25, its last commit was 2026-06-08 and it shipped 1 release in the last 90 days. 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-08-25, 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,204 · 2026-08-24
- Server Commands An MCP server to run arbitrary commands ★ 38,704 · 2026-08-05
- Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 4,780 · 2026-08-25
- Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,460 · 2026-08-25
- Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,598 · 2026-08-21
- Ship Swift 40+ production-ready SwiftUI recipes for building full-stack iOS apps via MCP. ★ 2,968 · 2026-08-09
More MCP servers to compare · Stack Overflow MCP Server · SEC EDGAR Filings MCP · Inav MCP · Apache Pinot MCP Server · 1stay
More TypeScript MCP servers · Squirrelscan · Diffgate · Mobile Device MCP · Agy Bridge · Openrouter Multimodal · see all