Advertise
MCP.so
Sign In

Timebook MCP Server

@squidcode

Repository

Basic information

Category

Developer Tools

Transports

stdio

Author

squidcode

Submitted by

Tamas Kalman

About Timebook MCP Server

Time tracking, invoicing, and lightweight bookkeeping for solo LLCs and freelancers. Ships with an MCP server so Claude, Cursor, or any MCP-speaking agent can start/stop timers, log time, list projects, and review entries directly — no browser tab. Available as the @squidcode/tim

#time-tracking#invoicing#freelance#bookkeeping#productivity#saas

Timebook MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Timebook MCP Server tools

12

Return the currently authenticated Timebook user (id, email, name).

List all projects available to the current token. Returns id, name, and client for each project.

List all clients available to the current token.

Return the currently running timer (project, description, started_at), or null if no timer is running.

Start a timer on a project. Stops any other running timer first — Timebook allows only one active timer at a time.

Stop the currently running timer. Returns { stopped: false } if no timer was running.

Log a manual (past) time entry. Provide either `duration` (relative to now), or both `startTime` and `endTime` (absolute ISO-8601 timestamps).

List recent time entries, optionally filtered by project and/or date range. Returns at most 50 entries by default; pass a higher `limit` to see more.

Edit one or more fields on an existing time entry. Any combination is valid; unset fields are left as-is. Server-enforced authorship rule: this token can only edit entries it created itself (sessions and admins bypass).

Delete a time entry. Server enforces: not invoiced, and either this token created it or the caller is an admin / web session.

Create a client (the person/company you bill). Needed before any project or time entry can exist. Typical first step on a fresh account.

Create a project under a client. Time entries are always tracked against a project. Typical second step on a fresh account, after create_client.

Overview

What is Timebook?

Timebook is a time tracking, invoicing, and lightweight bookkeeping tool built for solo LLCs and freelancers. It ships with an MCP server so AI agents (Claude Code, Cursor, Claude.ai, or any MCP-speaking client) can manage your time directly from your workflow.

How to use Timebook?

Install via stdio by adding a JSON config to your MCP client and running npx @squidcode/timebook login once to authenticate. For remote use (e.g., Claude.ai web), add the endpoint https://usetimebook.com/mcp as a connector; OAuth 2.0 handles authorization with a consent screen.

Key features of Timebook

  • Start and stop timers on any project
  • Log a discrete time entry with a duration
  • List clients, projects, and active timers
  • Query recent entries with filters
  • Inspect, update, or delete a specific entry

Use cases of Timebook

  • Freelancer asks an AI agent to log 45 minutes on a client project
  • Solo LLC owner starts a timer from within an IDE without opening a browser tab
  • Agent automatically records time based on task context and wraps up when done
  • User queries all recent entries to review billable hours for the week

Frequently asked questions

1

How does Timebook differ from traditional time trackers?

Existing trackers assume a human flipping a switch in a browser tab. Timebook flips it around: your AI logs the time, so you stay in flow.

2

What transports does the MCP server support?

Stdio for desktop clients (Claude Desktop, Cursor, Claude Code, Continue) and Streamable-HTTP with full OAuth 2.0 for remote use like Claude.ai web.

3

Where is the authentication token stored?

After running the login command, a scoped token is written to a local config file with mode `0600`. No token paste is required.

4

What runtime or dependencies are needed?

The server runs via npx (Node.js) for stdio mode. No other external dependencies are mentioned.

5

Who is Timebook built for?

Solo LLCs and freelancers. One price with no tiers, no per-seat fees, and no upsells.

Comments

More Developer Tools MCP servers

Crawl Readiness

Grubbomatic

AI SEO tools for MCP clients — audit whether AI crawlers can read a website, validate JSON-LD and robots.txt, and generate llms.txt, AI-crawler-aware robots.txt, and JSON-LD schema without leaving the conversation.

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.

12

Layro

Layro

Layro connects your AI coding tool (Cursor, Claude Code, VS Code, Windsurf, Codex, Gemini CLI) to 112 production React, TypeScript and Tailwind CSS components. Your agent can search the library, read each component's pro

Yocoolab

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools

1

Modelglass

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

1
Advertise