Timebook
Connect Claude to your Timebook account for time tracking through conversation. The server exposes eight tools: start and stop timers, log manual entries with duration or time ranges, list projects and clients, fetch active timers, and edit or delete entries. Authentication happens once via `timebook login`, which opens a browser OAuth flow and stores the token locally. Works as a local stdio server in Claude Desktop or as a remote connector at usetimebook.com/mcp with full OAuth for Claude.ai web. Useful when you want to track billable hours without leaving your chat window or need an agent to pull time reports across projects. Token permissions are scoped to specific clients and projects during login.
- tools
- 10
- transport
- STDIO, HTTP
- env vars
- 2
- last updated
- Jun 5, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
whoamiCurrent authenticated user (read-only)
Current authenticated user (read-only)
No parameter schema in public metadata yet.
list_projectsAll projects in scope (read-only)
All projects in scope (read-only)
No parameter schema in public metadata yet.
list_clientsAll clients in scope (read-only)
All clients in scope (read-only)
No parameter schema in public metadata yet.
get_active_timerThe running timer, or null (read-only)
The running timer, or null (read-only)
No parameter schema in public metadata yet.
start_timerStart a timer on a project
Start a timer on a project
No parameter schema in public metadata yet.
stop_timerStop the running timer
Stop the running timer
No parameter schema in public metadata yet.
log_timeLog a manual entry (duration OR startTime+endTime)
Log a manual entry (duration OR startTime+endTime)
No parameter schema in public metadata yet.
list_entriesRecent entries (default 50, max 500), project + date filters
Recent entries (default 50, max 500), project + date filters
No parameter schema in public metadata yet.
update_entryEdit one or more fields on an entry (description, duration, startTime, endTime, project, rate). Token must own the entry.
Edit one or more fields on an entry (description, duration, startTime, endTime, project, rate). Token must own the entry.
No parameter schema in public metadata yet.
delete_entryDelete an entry. Token must own it. Invoiced entries are locked.
Delete an entry. Token must own it. Invoiced entries are locked.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
TIMEBOOK_API_URLOverride the Timebook API base URL. Defaults to https://usetimebook.com.
TIMEBOOK_WEB_URLOverride the Timebook web URL used during `timebook login`. Defaults to https://usetimebook.com.
Readme
Timebook CLI
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.
Install
# one-off
npx @squidcode/timebook login
# globally
npm install -g @squidcode/timebook
timebook --help
Requires Node.js 18.17+.
Authenticate
timebook login opens your browser, you log into Timebook (or use an existing session) and pick a scope (which clients/projects this token can touch). The browser delivers the token back to a short-lived loopback HTTP listener, which the CLI then writes to a config file with 0600 permissions.
timebook login
The token is stored at:
Details
- Repository
- github.com/squidcode/timebook-cli
- Website
- usetimebook.com
- Category
- Monitoring & Observability
- Package
@squidcode/timebook- Transport
- STDIO, HTTP
- Registry
- MCP registry, active
Related Monitoring & Observability MCP servers
View all
Gizmoanalyticssudomichael/analyticsautopilotCookieless analytics for AI coding agents. Install in one prompt, 28 tools, OAuth onboarding.0stars
Mcptdnupe3/mcp-server-coinrailz63 paid services via USDC: crypto analytics, satellite, IoT, AI inference, prediction markets.0stars
Agentscorethezenmonster/agentscoresMCP security trust layer: scan packages, inspect repos, check exposure, monitor changes.0stars
Reviewmetricvktr93/reviewmetric-mcpAn MCP server connecting Claude to the Review Metric 15-agent scientific peer review pipeline.0stars
Mcp Alertmanagerjeanlopezxyz/mcp-alertmanagerA Model Context Protocol (MCP) server for Prometheus Alertmanager0stars
Jmpy Mcp Serverjmpy-me/jmpy-mcp-serverOfficial JMPY.me MCP Server: URL shortener, QR codes, and 70+ marketing analytics tools.0stars