Каталог MCP
squidcode/timebook-cli

squidcode/timebook-cli

Name: squidcode/timebook-cli
Availability: InStock
Author: squidcode

MCP-сервер для Timebook — трекинг времени и управление таймерами. Интегрируется с AI-агентами (Claude, Codex, Cursor) через CLI или удаленный HTTP с OAuth. Позволяет запускать/останавливать таймеры...

Github NPM Сайт сервера

README

12 инструментов

Версии

Установить сервер

Timebook CLI

Command-line client and MCP server for Timebook — track time, manage timers, and expose your Timebook account to AI agents (Claude, Codex, Cursor, …) over the Model Context Protocol.

license

Install

# one-off
npx @squidcode/timebook login

# globally
npm install -g @squidcode/timebook
timebook --help

Requires Node.js 18.17+.

Authenticate

timebook login opens your browser, you log into Timebook (or use an existing session) and pick a scope (which clients/projects this token can touch). The browser delivers the token back to a short-lived loopback HTTP listener, which the CLI then writes to a config file with 0600 permissions.

timebook login

The token is stored at:

macOS: ~/Library/Preferences/timebook/config.json
Linux: ~/.config/timebook/config.json
Windows: %APPDATA%\timebook\Config\config.json

The token never leaves your machine after login. To revoke it server-side, visit https://usetimebook.com/settings/api-tokens.

Use it as a CLI

timebook whoami
timebook projects                         # list projects
timebook clients                          # list clients

timebook start -p "Acme website" -d "Wireframes"
timebook status                           # show running timer
timebook stop

# manual entries
timebook log -p "Acme website" -t 1h30m -d "Code review"
timebook log -p PROJ_ID --start 2026-05-04T09:00 --end 2026-05-04T10:30

timebook entries --project "Acme website" -n 10

# edit / delete (any combination of fields; unset ones stay as-is)
timebook entries edit ENTRY_ID -t 2h -d "code review + tests"
timebook entries edit ENTRY_ID --start 2026-05-04T09:00 --end 2026-05-04T11:00
timebook entries edit ENTRY_ID -d ""                    # clear description
timebook entries delete ENTRY_ID

Инструменты были проиндексированы: 15.10.2026

create_clientвнешний мир

Создаёт клиента (человека/компанию, которым выставляете счёт). Необходимо до того, как может существовать любой проект или запись времени. Обычный первый шаг на новом аккаунте.

Параметры

emailstring
Необязательный email для счетов и связи.
namestringобязательный
Имя клиента, например 'Acme Corp'.

create_projectвнешний мир

Создать проект у клиента. Записи времени всегда привязываются к проекту. Типичный второй шаг на новом аккаунте, после create_client.

Параметры

clientstringобязательный
Клиент - id или точное имя.
descriptionstring
Необязательное описание проекта.
namestringобязательный
Название проекта, например 'Редизайн сайта'.

delete_entryидемпотентныйвнешний мир

Удаляет запись времени. Сервер проверяет: запись не выставлена в счет, и либо этот токен создал ее, либо вызывающий является администратором / веб-сессией.

Параметры

idstringобязательный
Идентификатор записи (uuid).

get_active_timerтолько чтениеидемпотентныйвнешний мир

Возвращает текущий запущенный таймер (project, description, started_at) или null, если таймер не запущен.

Параметры

Без параметров.

list_clientsтолько чтениеидемпотентныйвнешний мир

Вывести список всех клиентов, доступных текущему токену.

Параметры

Без параметров.

list_entriesтолько чтениеидемпотентныйвнешний мир

Выводит последние записи времени, опционально отфильтрованные по проекту и/или диапазону дат. По умолчанию возвращает не более 50 записей; передайте большее значение limit, чтобы увидеть больше.

Параметры

endDatestring
ISO-8601 - только записи, время начала которых не позже указанного значения.
limitinteger
Максимальное число возвращаемых записей. По умолчанию: 50.
projectstring
Необязательный идентификатор проекта или точное имя. Если не указано, выводится список по всем проектам.
startDatestring
ISO-8601: только записи, время начала которых не раньше этого времени.

list_projectsтолько чтениеидемпотентныйвнешний мир

Вывести список всех проектов, доступных текущему токену. Возвращает id, имя и клиента для каждого проекта.

Параметры

Без параметров.

log_timeвнешний мир

Регистрирует ручную (прошлую) запись времени. Принимает либо duration (относительно текущего момента), либо оба параметра startTime и endTime (абсолютные метки времени в формате ISO-8601).

Параметры

descriptionstring
Над чем работал пользователь.
durationstring
Сколько времени заняла работа. Принимает значения "1h", "45m", "1h30m", "1.5h", "1:30" или "90" (интерпретируется как минуты).
endTimestring
Время окончания в формате ISO-8601. Обязательно, если длительность не указана.
projectstringобязательный
Идентификатор проекта (UUID) или точное название проекта.
ratestring
Необязательный идентификатор ставки или точное название ставки (например, "Software Development").
startTimestring
Время начала в формате ISO-8601 (например, "2026-05-04T09:00:00Z"). Обязательно, если не указана длительность.

start_timerвнешний мир

Запускает таймер на проекте. Сначала останавливает любой другой работающий таймер: Timebook позволяет только один активный таймер за раз.

Параметры

descriptionstring
Над чем работает пользователь (видно в записи времени).
projectstringобязательный
Идентификатор проекта (UUID) или точное название проекта. Используйте list_projects, чтобы узнать его.
ratestring
Необязательный идентификатор ставки (UUID) или точное название ставки (например, "Software Development").

stop_timerидемпотентныйвнешний мир

Останавливает текущий запущенный таймер. Возвращает { stopped: false }, если никакой таймер не был запущен.

Параметры

Без параметров.

update_entryвнешний мир

Редактирует одно или несколько полей в существующей записи времени. Допустима любая комбинация; незаданные поля остаются без изменений. Правило авторства, применяемое сервером: этот токен может редактировать только те записи, которые он сам создал (сессии и администраторы обходят это ограничение).

Параметры

descriptionstring | null
Новое описание / заметка. Передайте пустую строку или null, чтобы очистить.
durationstring
Новая длительность, например, "1h30m" или "45m".
endTimestring
Время окончания ISO-8601.
idstringобязательный
Идентификатор записи (uuid).
projectstring
Reassign: идентификатор или имя проекта.
ratestring
Новая ставка - id или имя.
startTimestring
Время начала в формате ISO-8601.

whoamiтолько чтениеидемпотентныйвнешний мир

Возвращает текущего аутентифицированного пользователя Timebook (id, email, name).

Параметры

Без параметров.

`0.6.0`основная	05.06.2026
`0.5.0`	10.05.2026
`0.4.0`	10.05.2026
`0.3.0`	09.05.2026
`0.2.1`	04.05.2026
`0.2.0`	04.05.2026
`0.1.4`	04.05.2026
`0.1.3`	04.05.2026
`0.1.2`	04.05.2026
`0.1.1`	04.05.2026
`0.1.0`	04.05.2026

Выберите клиент, чтобы установить squidcode/timebook-cli:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "squidcode-timebook-cli-jjczq54mqx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@squidcode/timebook",
        "mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"squidcode-timebook-cli-jjczq54mqx\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@squidcode/timebook\",\"mcp\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add squidcode-timebook-cli-jjczq54mqx -- npx -y @squidcode/timebook mcp

Либо через JSON-конфиг:

claude mcp add-json squidcode-timebook-cli-jjczq54mqx "{\"command\":\"npx\",\"args\":[\"-y\",\"@squidcode/timebook\",\"mcp\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add squidcode-timebook-cli-jjczq54mqx -- npx -y @squidcode/timebook mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.squidcode-timebook-cli-jjczq54mqx]
command = "npx"
args = ["-y", "@squidcode/timebook", "mcp"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите squidcode/timebook-cli, а в поле команды запуска — строку ниже:

npx -y @squidcode/timebook mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "squidcode-timebook-cli-jjczq54mqx": {
      "command": "npx",
      "args": [
        "-y",
        "@squidcode/timebook",
        "mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например squidcode-timebook-cli-jjczq54mqx.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: squidcode-timebook-cli-jjczq54mqx
    command: npx
    args:
      - "-y"
      - "@squidcode/timebook"
      - "mcp"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 2
Форков на Github: 0
Загрузок: 2 773
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 09:55
Идентификатор: iFBGBFJhwLByqFaE
Категории: Рабочее место и продуктивность

squidcode/timebook-cli

Timebook CLI

Install

Authenticate

Use it as a CLI

Похожие MCP-сервера

louis030195/toggl-mcp

orellazi/coda-mcp

re-port-flow/reportflow-mcp

softeria/ms-365-mcp-server

MAG-Cie/mcp-microsoft-todo

k-jarzyna/mcp-miro