广告合作
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 服务器

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

9

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.

JiCo for Jira & Confluence – PII-redacting MCP server with Human-in-the-Loop

drkv-com

JiCo for Jira & Confluence: local MCP server for Jira Data Center - redacts personal data before the AI model, holds every write for approval

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

50

AptiBuild AI — Career Intelligence

ParklandBuilds

AptiBuild AI — Career Intelligence MCP Server Structured career decision scaffolding for AI agents. Provides personality-conditioned business idea generation, official BLS OEWS wage data, FRED labor market signals, and

广告合作