广告合作
MCP.so
登录

Timebook MCP Server

@squidcode

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

squidcode

提交者

Tamas Kalman

关于 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 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Timebook MCP Server 工具

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.

概览

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

常见问题

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.

评论

开发工具 分类下的更多 MCP 服务器

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

Total CMS

Joe Workman

Read-only Total CMS docs and site content over MCP: exact Twig signatures, field types, schema options, the CLI, release notes and comparisons. No key required.

MilliGate (x402 Crypto Paywall)

MilliGate Core

MilliGate is a developer-first remote MCP server that functions as a secure crypto paywall. By leveraging the HTTP 402 (Payment Required) protocol, it allows developers to monetize AI agents, APIs, and digital infrastruc

Termany

thinkany-ai

Agent-Native Terminal

174

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

3
广告合作