Tracks time on Timebook from agents: manage clients and projects, start and stop timers, and log, edit or delete time entries.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add timebook-cli -- npx -y @squidcode/timebook~/.codex/config.toml
[mcp_servers.timebook-cli]
command = "npx"
args = ["-y", "@squidcode/timebook"]
# codex mcp add timebook-cli -- npx -y @squidcode/timebook~/.cursor/mcp.json
{
"mcpServers": {
"timebook-cli": {
"command": "npx",
"args": [
"-y",
"@squidcode/timebook"
]
}
}
}.vscode/mcp.json
{
"servers": {
"timebook-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@squidcode/timebook"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"timebook-cli": {
"command": "npx",
"args": [
"-y",
"@squidcode/timebook"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"timebook-cli": {
"command": "npx",
"args": [
"-y",
"@squidcode/timebook"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"timebook-cli": {
"command": "npx",
"args": [
"-y",
"@squidcode/timebook"
]
}
}
}Remote
claude mcp add --transport http timebook-cli https://usetimebook.com/mcp~/.codex/config.toml
[mcp_servers.timebook-cli]
url = "https://usetimebook.com/mcp"
# codex mcp add timebook-cli --url https://usetimebook.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"timebook-cli": {
"url": "https://usetimebook.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"timebook-cli": {
"type": "http",
"url": "https://usetimebook.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"timebook-cli": {
"httpUrl": "https://usetimebook.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"timebook-cli": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://usetimebook.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"timebook-cli": {
"url": "https://usetimebook.com/mcp"
}
}
}