Skip to content
MCP server

Weeeking

Rust MCP server covering the full Weeek API: tasks, projects, CRM and time tracking

Runs locallyStatus and history
Install
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 weeeking

Add 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.

How AIPoweredBot checks servers