MCP.so
Sign In

Timebook

@squidcode

Repository

About Timebook

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

Config

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

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

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

FAQ from Timebook

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.

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.

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.

What runtime or dependencies are needed?

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

Who is Timebook built for?

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

Frequently asked questions

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.

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.

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.

What runtime or dependencies are needed?

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

Who is Timebook built for?

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

Comments

Basic information

Category

Developer Tools

Transports

stdio

Author

squidcode

Submitted by

Tamas Kalman

More Developer Tools MCP servers

Routebase

Routebase

Routebase keeps your API's design, docs, contract tests, mocks and monitoring in one living OpenAPI spec so they can't drift apart. Agents work on that same source of truth, under your team's permissions.

LocalCan

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

82

Skilder.ai

skilder.ai

Run skills and MCP tools like production software: versioned, composed into roles, distributed to every agent from one governed library.

OrangePro

Aamir Siddiqui

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

12
S

SecondSim

econdSim provisions real UK mobile numbers (non-VoIP) via eSIM, built for freelancers, sole traders, small businesses, and enterprise teams. Unlike VoIP apps and virtual numbers, SecondSim numbers register as genuine phy