Timebook Cli vs Ttctl
A side-by-side look at the Timebook Cli and Ttctl MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Timebook Cli for workplace & productivity work as a local process; choose Ttctl for workplace & productivity as a local process. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose Timebook Cli when
- You need dedicated capabilities in the Workplace & Productivity domain.
- You prefer a local stdio subprocess transport.
- You have the keys it needs:
TIMEBOOK_API_URL, TIMEBOOK_WEB_URL. - You want tools like
whoami, list_projects, list_clients.
Choose Ttctl when
- You need dedicated capabilities in the Workplace & Productivity domain.
- You prefer a local stdio subprocess transport.
- Its auth model fits you: other.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Workplace & Productivity | Workplace & Productivity |
| Quality signal | 56/100 · Good | 44/100 · Fair |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | Not declared | other |
| Pricing | Not declared | Free |
| Required env vars | TIMEBOOK_API_URLTIMEBOOK_WEB_URL |
Tools & capabilities
Timebook Cli tools 10
whoamiCurrent authenticated user (read-only)list_projectsAll projects in scope (read-only)list_clientsAll clients in scope (read-only)get_active_timerThe running timer, or `null` (read-only)start_timerStart a timer on a projectstop_timerStop the running timerlog_timeLog a manual entry (`duration` OR `startTime`+`endTime`)list_entriesRecent entries (default 50, max 500), project + date filtersupdate_entryEdit one or more fields on an entry (description, duration, startTime, endTime, project, rate). Token must own the entry.delete_entryDelete an entry. Token must own it. Invoiced entries are locked.
Ttctl tools
No tool names declared yet. Check the project README from the listing page.
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
Timebook Cli
{
"mcpServers": {
"squidcode-timebook-cli": {
"command": "npx",
"args": [
"-y",
"@squidcode/timebook"
],
"env": {
"TIMEBOOK_API_URL": "YOUR_TIMEBOOK_API_URL_HERE",
"TIMEBOOK_WEB_URL": "YOUR_TIMEBOOK_WEB_URL_HERE"
}
}
}
}
Ttctl
{
"mcpServers": {
"ttctl": {
"command": "npx",
"args": [
"-y",
"ttctl"
]
}
}
}
Frequently asked questions
Timebook Cli is categorized under Workplace & Productivity and uses a local stdio subprocess. Ttctl belongs to Workplace & Productivity and uses a local stdio subprocess. Pick Timebook Cli for workplace & productivity work and Ttctl for workplace & productivity.
Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.
Timebook Cli has no declared pricing — check the project's own site. Ttctl is listed as free. Auth: other. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.
Yes. MCP clients support multiple servers: add squidcode-timebook-cli and ttctl as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Timebook Cli has a quality signal of 56/100 (Good) with 2 views, 0 installs and 2 GitHub stars. Ttctl has 44/100 (Fair) with 3 views, 0 installs and 0 GitHub stars.