Enables AI clients to manage tasks, projects, CRM, and time tracking via the full Weeek public API.
Also known as OniVe/weeeking
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.6.0
- Last commit
- Nov 13, 2026
- License
- MIT
What is Weeeking MCP?
Weeeking enables AI clients to manage tasks, projects, CRM, and time tracking via the full Weeek public API.
Summary generated from the project's README
About Weeeking MCP server
Weeeking provides a bridge between AI clients and the Weeek platform, allowing users to manage projects, tasks, CRM data, and time tracking through a single interface. The server implements 157 operations from the official OpenAPI specification, covering everything from boards and columns to deals, contacts, and organizations. It is built in Rust as a single binary, making it highly portable across Windows, Linux, and macOS without requiring Node.js or other external runtimes.
Users can run the server locally via stdio or through an npm wrapper using npx. To function, the server requires a WEEEK_API_TOKEN, which can be provided via environment variables or securely stored in system keychains like macOS Keychain or Windows Credential Manager. For security, the server defaults to a read-only mode, requiring users to explicitly set READ_ONLY to false to enable modifying actions such as creating tasks or updating deals. It also includes specialized tools for searching tasks, downloading attachments, and managing comments.
Written from the project's README. Every use case is checked against a quote from it.
How to install Weeeking MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Weeeking MCP in Claude Code
$ claude mcp add --env 'WEEEK_API_TOKEN=<YOUR_WEEEK_API_TOKEN>' --env 'WEEEK_TOKEN=<YOUR_WEEEK_TOKEN>' weeeking -- npx -y weeekingInstall Weeeking MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"weeeking": {
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<YOUR_WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<YOUR_WEEEK_TOKEN>"
}
}
}
}Install Weeeking MCP in VS Code
.vscode/mcp.json
{
"servers": {
"weeeking": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<YOUR_WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<YOUR_WEEEK_TOKEN>"
}
}
}
}Install Weeeking MCP in VS Code CLI
$ code --add-mcp '{"name":"weeeking","type":"stdio","command":"npx","args":["-y","weeeking"],"env":{"WEEEK_API_TOKEN":"<YOUR_WEEEK_API_TOKEN>","WEEEK_TOKEN":"<YOUR_WEEEK_TOKEN>"}}'Install Weeeking MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"weeeking": {
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<YOUR_WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<YOUR_WEEEK_TOKEN>"
}
}
}
}Install Weeeking MCP in Codex
$ codex mcp add weeeking --env 'WEEEK_API_TOKEN=<YOUR_WEEEK_API_TOKEN>' --env 'WEEEK_TOKEN=<YOUR_WEEEK_TOKEN>' -- npx -y weeekingInstall Weeeking MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.weeeking] command = "npx" args = ["-y", "weeeking"] [mcp_servers.weeeking.env] WEEEK_API_TOKEN = "<YOUR_WEEEK_API_TOKEN>" WEEEK_TOKEN = "<YOUR_WEEEK_TOKEN>"
Install Weeeking MCP in Gemini CLI
$ gemini mcp add -s user -e 'WEEEK_API_TOKEN=<YOUR_WEEEK_API_TOKEN>' -e 'WEEEK_TOKEN=<YOUR_WEEEK_TOKEN>' weeeking npx -- -y weeekingInstall Weeeking MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"weeeking": {
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<YOUR_WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<YOUR_WEEEK_TOKEN>"
}
}
}
}Configuration
WEEEK_API_TOKENSecretWeeek API token (Weeek: Settings → API). Alternative: store it with `weeeking store-token`.
WEEEK_TOKENSecretAlias for WEEEK_API_TOKEN (checked second).
READ_ONLYtrue (default) — read-only mode: write tools are hidden. Set false to allow changes.
WEEEK_ALLOW_ACTIONSAbsolute allow list of OpenAPI operation ids/masks (comma/space separated): anything not listed is forbidden; a set-but-empty value is a startup error. Cannot be combined with WEEEK_PROFILE.
WEEEK_BASE_URLCustom API base URL (proxy or self-hosted gateway).
WEEEK_DENY_ACTIONSDeny list of OpenAPI operation ids/masks (e.g. delete-*): denied operations are hidden and rejected on call; a set-but-empty value is a startup error.
WEEEK_DISABLE_KEYCHAIN1 — do not read the token from the system keychain (Credential Manager / Keychain / Secret Service).
WEEEK_KEYCHAIN_ACCOUNTWEEEK_LANGLanguage of user-facing texts: ru (default) or en — help, tool descriptions, prompts, errors.
WEEEK_LOGdebug — verbose HTTP logs to stderr (no token).
WEEEK_MAX_RESPONSE_CHARSMaximum response size in characters (default 60000).
WEEEK_PROFILEReady access profile: executor — reads plus task and comment creation only.
WEEEK_RPSClient-side request rate limit in requests per second (token bucket, retries included). Empty or <=0 disables it; values below 0.001 are rejected at startup.
WEEEK_RPS_BURSTBurst capacity in tokens (default: ceil(RPS), at least 1).
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableonive/weeeking is public and reachablegithub.com/onive/weeeking ↗Pass
- Package names this repository as its sourceweeeking names onive/weeeking as sourcenpmjs.com/package/weeeking ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for weeekingnpmjs.com/package/weeeking/v/0.6.0#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/onive/weeeking ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from weeekingPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubWeeeking 🛡️
Русский · English
Weeek and conquer. MCP-сервер для Weeek с полным покрытием публичного API: 157 операций из официальной OpenAPI-спецификации. Один бинарник на Rust, без Node и внешних зависимостей в рантайме. Релизы — для семи платформ: Windows x64/arm64, Linux x64 (glibc/musl), Linux arm64, macOS arm64/x64.
Возможности
- 13 админ-групп с
action—weeek_project,weeek_board,weeek_board_column,weeek_custom_fields,weeek_portfolio,weeek_tags,weeek_task(таймеры, записи времени, вложения, родитель…),weeek_funnels,weeek_funnel_statuses,weeek_deals,weeek_organizations,weeek_contacts,weeek_currencies. - 12 curated-тулов для повседневной работы:
weeek_context,weeek_search_tasks,weeek_get_task,weeek_list_comments,weeek_download_attachment+ записи (weeek_create_task,weeek_update_task,weeek_move_task,weeek_complete_task,weeek_set_task_people,weeek_add_comment,weeek_delete_comment). - READ_ONLY по умолчанию: изменяющие действия не регистрируются, пока не выставлено
READ_ONLY=false. - Ресурсы и промпты MCP:
weeek://meиweeek://projectsчитаются клиентом без tool-call; промпты «Мои задачи на сегодня» и «Итоги недели» — готовые сценарии для агента. - Эргономика LLM:
compact=trueубирает null и пустые значения (включая пустые элементы массивов) из тяжёлых ответов;fetchAll=true(+maxItems) собирает страницы задач и комментариев (страница по умолчанию 100, не более 50 страниц) с флагомtruncated. - Надёжность: ретраи 429 и 502/503/504 с
Retry-Afterи экспоненциальным бэкоффом (429 — для любого метода, 502/503/504 и сетевые сбои — только для GET/HEAD; таймауты не повторяются);WEEEK_LOG=debug— HTTP-логи в stderr (метод, путь, статус, длительность; без токена). - Кодогенератор спеки:
tools/update_spec.pyтянет OpenAPI с developers.weeek.net и генерируетsrc/spec_generated.rs— статические данные (&'static str), которые компилируются в бинарник; в рантайме нет ни JSON, ни парсинга, чанк спеки в репозитории не сохраняется.
Сборка
Требуется Rust 1.88+ (MSVC toolchain на Windows).
cargo build --release
# → target/release/weeeking.exe (Windows) / target/release/weeeking (Linux, macOS)
Релизы
Готовые бинарники — в GitHub Releases: архивы
weeeking-<версия>-<платформа> и сырые бинарники для npm-обёртки; рядом — файлы .sha256,
хэши также перечислены в описании релиза.
| Платформа | Архив | Сырой бинарник |
|---|---|---|
| Windows x64 | weeeking-<версия>-win-x64.zip |
weeeking-<версия>-win-x64.exe |
| Windows arm64 | weeeking-<версия>-win-arm64.zip |
weeeking-<версия>-win-arm64.exe |
| Linux x64 (glibc) | weeeking-<версия>-linux-x64.tar.gz |
weeeking-<версия>-linux-x64 |
| Linux x64 (musl, static) | weeeking-<версия>-linux-musl-x64.tar.gz |
weeeking-<версия>-linux-musl-x64 |
| Linux arm64 | weeeking-<версия>-linux-arm64.tar.gz |
weeeking-<версия>-linux-arm64 |
| macOS arm64 | weeeking-<версия>-osx-arm64.tar.gz |
weeeking-<версия>-osx-arm64 |
| macOS x64 | weeeking-<версия>-osx-x64.tar.gz |
weeeking-<версия>-osx-x64 |
# проверка контрольной суммы
certutil -hashfile weeeking-<версия>-win-x64.zip SHA256 # Windows
sha256sum -c weeeking-<версия>-linux-x64.tar.gz.sha256 # Linux
Каждый файл релиза подписан GitHub-аттестацией (Sigstore) — проверяемое происхождение сборки:
gh attestation verify weeeking-<версия>-win-x64.exe -R OniVe/weeeking
npm (npx)
npx -y weeeking # MCP-сервер по stdio; бинарник скачается и проверится по sha256
Пакет weeeking — тонкая обёртка: берёт нативный бинарник нужной платформы (Windows x64/arm64,
Linux x64 gnu/musl, Linux arm64, macOS arm64/x64) из GitHub Releases этой же версии. Публикуется
через npm trusted publishing (OIDC, с provenance).
Сервер также опубликован в официальном MCP Registry — io.github.OniVe/weeeking; оттуда его
подхватывают каталог GitHub MCP и агрегаторы.
На macOS скачанный через браузер бинарник может ловить карантин Gatekeeper — снимите его
(xattr -d com.apple.quarantine <файл>) или ставьте через npx/curl.
Переменные окружения
| Переменная | По умолчанию | Описание |
|---|---|---|
WEEEK_API_TOKEN |
— | Токен из Weeek (Настройки workspace → API). Без него чтения невозможны. |
READ_ONLY |
true |
false/0 — открыть изменяющие операции (создание, правка, удаление, CRM). |
WEEEK_ALLOW_ACTIONS |
— | Белый список операций (operationId или маски *): всё, что не перечислено (включая чтения), запрещено. Несовместим с WEEEK_PROFILE. |
WEEEK_DENY_ACTIONS |
— | Чёрный список операций (или масок: delete-*): не вызываются и не показываются. Сильнее белого списка и профиля. |
WEEEK_PROFILE |
— | Профиль доступа: executor — чтения плюс создание задач и комментариев. |
WEEEK_LANG |
ru |
Язык пользовательских текстов (ru/en): справка, описания инструментов, промпты, ошибки. |
WEEEK_BASE_URL |
https://api.weeek.net/public/v1 |
Свой прокси/хост при необходимости. |
WEEEK_TIMEOUT_MS |
30000 |
Таймаут запроса. |
WEEEK_MAX_RESPONSE_CHARS |
60000 |
Обрезка больших ответов. |
WEEEK_DISABLE_KEYCHAIN |
— | 1 — не читать токен из системного хранилища. |
WEEEK_KEYCHAIN_ACCOUNT |
api-token |
Имя записи в системном хранилище (для нескольких аккаунтов). |
WEEEK_MAX_ATTACHMENT_BYTES |
67108864 (64 МиБ) |
Лимит скачивания вложения (защита от гигантских ответов). |
WEEEK_RETRY_MAX |
2 |
Дополнительные попытки при 429, 502/503/504 и сетевых сбоях (0–5); таймауты не повторяются. |
WEEEK_RETRY_BASE_MS |
300 |
База экспоненциального бэкоффа (потолок 5 с; Retry-After учитывается, потолок 30 с). |
WEEEK_RPS |
— | Клиентский лимит запросов в секунду (token bucket; включая ретраи). Пустое/≤0 — выключен; 0 < RPS < 0.001 — ошибка старта. |
WEEEK_RPS_BURST |
ceil(RPS), минимум 1 |
Ёмкость всплеска в токенах. |
WEEEK_LOG |
— | debug — подробные HTTP-логи в stderr (метод, путь, статус, мс; токен не логируется). |
Откуда берётся токен
WEEEK_API_TOKEN(илиWEEEK_TOKEN) из окружения — приоритет всегда за ним.- В системном хранилище — запись сервиса
weeek-mcpс именемWEEEK_KEYCHAIN_ACCOUNT(по умолчаниюapi-token): Windows Credential Manager (targetapi-token.weeek-mcp), macOS Keychain, Linux Secret Service (GNOME Keyring/KWallet через D-Bus); сохраняется командойweeeking store-token. Значение никогда не логируется. - Если пусто — сервер поднимается, но вызовы возвращают
isErrorс подсказкой.
Системное хранилище работает на всех платформах; на headless-Linux без D-Bus его нет — задайте
токен переменными окружения WEEEK_API_TOKEN или WEEEK_TOKEN.
Несколько аккаунтов Weeek
Личность действий (автор комментариев, задач) определяется токеном: API всегда действует от владельца токена. Для второго пользователя нужен его собственный токен (создаётся в Настройках workspace → API; доступ к разделу есть у супер-админов и админов).
# 1) Сохранить токен второго аккаунта (ввод скрыт, в argv токен не попадает)
weeeking store-token --account api-token-anna
# 2) Запуск сервера под этим аккаунтом
$env:WEEEK_KEYCHAIN_ACCOUNT = "api-token-anna"; weeeking # PowerShell (Windows)
WEEEK_KEYCHAIN_ACCOUNT=api-token-anna weeeking # bash/zsh (macOS, Linux)
Пример второго инстанса в конфиге OpenCode (нативная форма V2):
"mcp": {
"servers": {
"weeek-anna": {
"type": "local",
"command": ["C:\\путь\\weeeking.exe"],
"environment": {
"WEEEK_KEYCHAIN_ACCOUNT": "api-token-anna",
"READ_ONLY": "false"
}
}
}
}
Агент сможет выбирать, от кого действовать: тулы weeek-anna_* пишут от Анны, weeek_* — от основного аккаунта.
Удалить запись из хранилища: Windows — cmdkey /delete:api-token-anna.weeek-mcp;
macOS — security delete-generic-password -s weeek-mcp -a api-token-anna;
Linux — средствами вашего хранилища (GNOME Keyring / KWallet).
На headless-Linux без D-Bus системного хранилища нет: мультиаккаунт — отдельный инстанс сервера
с собственным WEEEK_API_TOKEN в окружении.
CLI
weeeking запустить MCP-сервер (stdio)
weeeking store-token [--account <имя>] сохранить токен в системное хранилище
weeeking --help справка
Ограничение операций
READ_ONLY — грубый переключатель: false открывает весь изменяющий API. Тоньше доступ
настраивается фильтром операций (по operationId из OpenAPI):
WEEEK_DENY_ACTIONS— чёрный список: перечисленные операции (или маски:delete-*) не вызываются и не показываются в описаниях инструментов;WEEEK_ALLOW_ACTIONS— абсолютный белый список: всё, что не перечислено (включая чтения), запрещено; несовместим сWEEEK_PROFILE;WEEEK_PROFILE=executor— готовый узкий профиль: чтения плюсcreate-taskиcreate-task-comment(создание задачи и комментария; без изменений и удалений).
Семантика: READ_ONLY=true сильнее списков и профиля (они игнорируются с предупреждением);
WEEEK_DENY_ACTIONS сильнее WEEEK_ALLOW_ACTIONS и профиля. Fail-closed: пустое значение
WEEEK_ALLOW_ACTIONS/WEEEK_DENY_ACTIONS и маска, не совпавшая ни с одной операцией OpenAPI,
останавливают сервер с ошибкой при старте; под READ_ONLY=true такие настройки игнорируются,
но о проблеме сообщается предупреждением. Списки разделяются запятыми и/или пробелами;
* в маске — любая подстрока.
Запрещённые действия не рекламируются в tools/list (действие исчезает из action-enum,
инструмент — из списка) и отклоняются при вызове с типизированной ошибкой. Ресурсы, промпты
и серверная инструкция тоже следуют политике: если контекст (weeek_context и ресурсы
weeek://me, weeek://projects) недоступен, он не рекламируется и не читается, а промпты,
опирающиеся на скрытые инструменты, пропадают из prompts/list.
# Запретить все удаления, остальное оставить:
READ_ONLY=false WEEEK_DENY_ACTIONS="delete-*" weeeking
# Узкий исполнитель: чтения, создание задач и комментариев:
READ_ONLY=false WEEEK_PROFILE=executor weeeking
# Явный белый список (абсолютный — чтения тоже перечисляются):
READ_ONLY=false WEEEK_ALLOW_ACTIONS="get-tasks,get-task,get-task-comments,create-task,create-task-comment" weeeking
Соответствие curated-инструментов операциям OpenAPI:
| Инструмент | Операции |
|---|---|
weeek_context |
get-profile, get-workspace, get-workspace-members, get-tags, get-projects (+get-boards, get-board-columns при аргументах projectId/boardId) |
weeek_search_tasks |
get-tasks |
weeek_get_task |
get-task, get-task-comments |
weeek_list_comments |
get-task-comments |
weeek_download_attachment |
get-attachment |
weeek_create_task |
create-task |
weeek_update_task |
update-task |
weeek_move_task |
change-task-board, change-task-board-column |
weeek_complete_task |
complete-task, uncomplete-task |
weeek_set_task_people |
add-assignees-to-task, remove-assignees-from-task, add-watchers-to-task, remove-watchers-from-task |
weeek_add_comment |
create-task-comment |
weeek_delete_comment |
delete-task-comment |
Инструмент доступен, только если разрешены все его операции (у weeek_context дополнительные
выборки get-boards/get-board-columns проверяются отдельно — при передаче projectId/boardId).
Админ-группы (weeek_project, weeek_task, …) фильтруют action-список: доступные операции
перечислены в описании инструмента.
Сосуществование потребителей
Weeek не публикует лимиты запросов, и они, по-видимому, общие на workspace. Когда рядом работают несколько потребителей (инстансы weeeking, сервис-синхронизатор, скрипты), бюджет можно сгладить:
WEEEK_RPS— клиентский лимит запросов в секунду для этого инстанса (token bucket): действует на все HTTP-запросы, включая повторные попытки;Retry-Afterне отменяется — пауза берётся не меньше предписанной API;WEEEK_RPS_BURST— допуск всплеска в токенах: по умолчанию «секунда запаса» (ceil(RPS), минимум 1) — короткая пачка укладывается в секунду без лишнего пейсинга; если при маломRPSпараллельные выборки не должны тормозить, задайте burst вручную;- по умолчанию throttle выключен; пустое или ≤0 значение — тоже выключен (baseline не меняется);
значения меньше
0.001отклоняются на старте (иначе один запрос ждал бы тысячи секунд).
Общий бюджет на несколько инстансов: разделите WEEEK_RPS между ними вручную или поставьте перед
API общий throttle-прокси и укажите его в WEEEK_BASE_URL — тогда лимит соблюдается суммарно.
# Строгий режим для сервиса-синхронизатора: 1 запрос/с без всплеска
READ_ONLY=false WEEEK_RPS=1 WEEEK_RPS_BURST=1 weeeking
# Интерактивный инстанс: в среднем 4 запроса/с, всплеск до 8
WEEEK_RPS=4 WEEEK_RPS_BURST=8 weeeking
Подключение (OpenCode)
Нативная форма OpenCode V2 — серверы живут в mcp.servers:
"mcp": {
"servers": {
"weeek": {
"type": "local",
"command": ["C:\\путь\\weeeking.exe"], // на любой ОС: ["npx", "-y", "weeeking"]
"environment": { "READ_ONLY": "false" }
}
}
}
Добавить из CLI: opencode mcp add weeek -- npx -y weeeking (с --global — для всех проектов).
Отключить сервер, не удаляя из конфига: "disabled": true (нативная V2-форма; V1-форма
"mcp": { "weeek": { … } } с enabled тоже поддерживается).
Любой другой MCP-клиент: команда — путь к бинарнику (или npx -y weeeking), транспорт — stdio.
Обновление спецификации
pip install quickjs # зависимость кодогенератора (один раз)
python tools/update_spec.py # developers.weeek.net → src/spec_generated.rs (кодогенерация)
cargo fmt && cargo build --release
Разработка
cargo fmt
cargo clippy --all-targets
cargo test # unit + mock-сюита (HTTP против эмулятора) + smoke
Приёмочный smoke против живого API (перед релизом; read-only по умолчанию):
python tools/live_smoke.py
python tools/live_smoke.py --write-test <PROJECT_ID> # + цикл мутаций в sandbox-проекте
Пересборка при работающем OpenCode (exe залочен запущенным MCP-сервером):
python tools\rebuild.py
Ограничения API Weeek (важно агенту)
- Описание задачи задаётся только при создании — позже не изменить.
tagsвweeek_update_taskзаменяет весь список — сначала прочитайте задачу.- Комментарии можно создать и удалить, но не отредактировать.
Участие
Проект открыт для вклада и вопросов: баг-репорты, идеи и вопросы — в issues (для типовых случаев есть шаблоны).
- Как собрать проект, какие проверки обязательны и что нужно для PR — в CONTRIBUTING.md.
- Участвуя в проекте, вы соглашаетесь с Кодексом поведения.
Мейнтейнер — @OniVe.
Безопасность
Об уязвимостях сообщайте приватно — см. SECURITY.md. Токены не попадают в логи; не прикладывайте их к issue и PR.
Лицензия
MIT — см. LICENSE.
Weeeking MCP questions
How do I add Weeeking MCP to Claude Code?
Run claude mcp add --env 'WEEEK_API_TOKEN=<YOUR_WEEEK_API_TOKEN>' --env 'WEEEK_TOKEN=<YOUR_WEEEK_TOKEN>' weeeking -- npx -y weeeking in your terminal. Add --scope user to make it available in every project.
How do I add Weeeking MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I run the server without Node.js?
The server is a single binary written in Rust, which means it has no Node or external dependencies in the runtime.