# Weeeking

> Weeeking is an open-source MCP server for productivity. Rust MCP server covering the full Weeek API: tasks, projects, CRM and time tracking. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, Linux, macOS, CLI
- **Repository:** https://github.com/onive/weeeking
- **MCP Registry name:** io.github.OniVe/weeeking
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add weeeking --env WEEEK_API_TOKEN='<WEEEK_API_TOKEN>' --env WEEEK_TOKEN='<WEEEK_TOKEN>' -- npx -y weeeking
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "weeeking": {
      "command": "npx",
      "args": [
        "-y",
        "weeeking"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
        "WEEEK_TOKEN": "<WEEEK_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "weeeking": {
      "command": "npx",
      "args": [
        "-y",
        "weeeking"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
        "WEEEK_TOKEN": "<WEEEK_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "weeeking": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "weeeking"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
        "WEEEK_TOKEN": "<WEEEK_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "weeeking": {
      "command": "npx",
      "args": [
        "-y",
        "weeeking"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
        "WEEEK_TOKEN": "<WEEEK_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "weeeking": {
      "command": "npx",
      "args": [
        "-y",
        "weeeking"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<WEEEK_API_TOKEN>",
        "WEEEK_TOKEN": "<WEEEK_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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

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

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp-2): Google Workspace MCP is an MCP server for productivity.
- [Google_calendar](https://ai-powered.com/mcp/google-calendar-3): Google_calendar is a freemium MCP server for productivity.
- [Zovo Org Chart Maker](https://ai-powered.com/mcp/zovo-org-chart-maker): Zovo Org Chart Maker is an MCP server for productivity.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/weeeking
