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.

Local + remotestreamable-httpstdioMIT

What is the Timebook MCP Server?

Timebook is an MCP project maintained in the squidcode/timebook-cli repository. The maintainer describes its purpose as “Command-line client and MCP server for Timebook — track time, manage timers, and expose your Timebook account to AI agents (Claude, Codex, Cursor, …) over…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @squidcode/timebook. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
whoami	Current authenticated user (read-only)
list_projects	All projects in scope (read-only)
list_clients	All clients in scope (read-only)
get_active_timer	The running timer, or null (read-only)
start_timer	Start a timer on a project
stop_timer	Stop the running timer
log_time	Log a manual entry (duration OR startTime+endTime)
list_entries	Recent entries (default 50, max 500), project + date filters
update_entry	Edit one or more fields on an entry (description, duration, startTime, endTime, project, rate). Token must own the entry.
delete_entry	Delete an entry. Token must own it. Invoiced entries are locked.

How to install the Timebook MCP Server

{
  "mcpServers": {
    "timebook": {
      "command": "npx",
      "args": [
        "-y",
        "@squidcode/timebook",
        "mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.