Weeeking
Rust MCP server covering the full Weeek API: tasks, projects, CRM and time tracking
- Pricing
- Open source
- Platforms
- Windows, Linux, macOS
- Runs
- Locally
- Version
- 0.6.0
- Listing updated
- today
Similar MCP servers
About Weeeking
Weeeking is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
Weeeking is a single native binary written in Rust, with no Node or other runtime needed, that implements all 157 operations of Weeek's official OpenAPI spec. The README is in Russian with an English version, and tool descriptions and prompts default to Russian but can be switched to English.
It starts read-only: write tools are not even registered until READ_ONLY is set to false. Finer control comes from allow and deny lists of operation ids, or a ready profile called executor that allows reads plus creating tasks and comments. The API token can come from an environment variable or from the system keychain, and a second Weeek user can be served by storing their own token under another keychain account.
For daily use there are twelve curated tools alongside thirteen admin groups that take an action argument. Options such as compact responses, fetch-all paging, retry with backoff on 429 and 5xx, a client-side rate limit and an attachment size cap keep large workspaces manageable. Releases exist for seven platform builds and carry SHA-256 files and Sigstore attestations.
Install
Run in a terminal
claude mcp add weeeking --env WEEEK_API_TOKEN='<WEEEK_API_TOKEN>' --env WEEEK_TOKEN='<WEEEK_TOKEN>' -- npx -y weeekingAdd to claude_desktop_config.json
{
"mcpServers": {
"weeeking": {
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<WEEEK_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"weeeking": {
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<WEEEK_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"weeeking": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<WEEEK_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"weeeking": {
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<WEEEK_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"weeeking": {
"command": "npx",
"args": [
"-y",
"weeeking"
],
"env": {
"WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
"WEEEK_TOKEN": "<WEEEK_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
WEEEK_API_TOKENWeeek API token (Weeek: Settings → API). Alternative: store it with `weeeking store-token`.WEEEK_TOKENAlias for WEEEK_API_TOKEN (checked second).READ_ONLYtrue (default) — read-only mode: write tools are hidden. Set false to allow changes.WEEEK_LANGLanguage of user-facing texts: ru (default) or en — help, tool descriptions, prompts, errors.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_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_PROFILEReady access profile: executor — reads plus task and comment creation only.WEEEK_BASE_URLCustom API base URL (proxy or self-hosted gateway).WEEEK_DISABLE_KEYCHAIN1 — do not read the token from the system keychain (Credential Manager / Keychain / Secret Service).WEEEK_MAX_RESPONSE_CHARSMaximum response size in characters (default 60000).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).WEEEK_LOGdebug — verbose HTTP logs to stderr (no token).
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- weeek_context
- Curated tool for workspace context
- weeek_search_tasks
- Searches tasks
- weeek_get_task
- Reads one task
- weeek_list_comments
- Lists comments on a task
- weeek_download_attachment
- Downloads a task attachment
- weeek_create_task
- Creates a task
- weeek_update_task
- Updates a task
- weeek_move_task
- Moves a task
- weeek_complete_task
- Completes a task
- weeek_set_task_people
- Sets the people on a task
- weeek_add_comment
- Adds a comment
- weeek_delete_comment
- Deletes a comment
What it does
- Full API coverage
- Implements all 157 operations of Weeek's public OpenAPI spec.
- Read-only default
- Write tools stay hidden until READ_ONLY is switched off.
- Access profiles
- Allow lists, deny lists and an executor profile limit what the agent can do.
- LLM-friendly output
- Compact mode drops empty values and fetchAll gathers paged results with a truncation flag.
- Resilient requests
- Retries rate-limit and gateway errors with backoff and offers a client-side request limit.
- Keychain token storage
- Reads the API token from the OS keychain as an alternative to environment variables.
- Prompts and resources
- Includes weeek://me and weeek://projects resources and ready prompts such as today's tasks.
Good for
- Ask an agent for today's tasks in a Weeek workspace
- Create, move and complete tasks or add comments from chat
- Review CRM deals, contacts and funnels
- Log and inspect time-tracking entries
- Run a read-only weekly summary across projects
Pricing
Open source
Free open source; needs a Weeek account and API token
Weeeking FAQ
Is it safe to connect to a live workspace?
It is read-only by default, and deny lists can block operations such as delete-*.
Where does the API token come from?
Weeek workspace settings under API; it can be set in an environment variable or stored with weeeking store-token.
Which platforms are supported?
Windows x64 and arm64, Linux x64 (glibc and musl) and arm64, and macOS arm64 and x64.
How do I run it?
Run npx -y weeeking, which fetches and checks the native binary, or build it with Cargo.
Is Weeeking free?
Yes. Weeeking is open source, so you can use and self-host it for free.
How do I add Weeeking to Claude Code?
Run this command in your terminal: claude mcp add weeeking --env WEEEK_API_TOKEN='<WEEEK_API_TOKEN>' --env WEEEK_TOKEN='<WEEEK_TOKEN>' -- npx -y weeeking
What are the best alternatives to Weeeking?
The closest alternatives to Weeeking are Ha MCP, Concord MCP, note1, InviteKit Calendar Files and Google Workspace MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
