io.github.IlyaIvanchikov/weeek-mcp-smart — Model Context Protocol (MCP) Server

This MCP server provides access to WEEEK tasks by name rather than by task IDs. Its stated purpose is task lookup and retrieval using task names, making it suitable when you have human-readable task references instead of numeric identifiers.

🛠️ Key Features

WEEEK tasks queried by name, not IDs
Implemented as an MCP server (io.github.IlyaIvanchikov/weeek-mcp-smart)
Identified by slug: io-github-ilyaivanchikov-weeek-mcp-smart

🚀 Use Cases

Find and work with WEEEK tasks when you only know the task name
Integrate task retrieval into MCP-based developer workflows

⚠️ Limitations

Task access is name-based; it does not use task IDs according to the provided description

weeek-mcp-smart

The only one-click WEEEK MCP server — it takes names, not IDs. Create a task in one call:

code

weeek_create_task({ title: "Ship v1", project: "Marketing",
                    column: "In Progress", assignee: "Ilya", due: "next friday" })

No list_projects → list_boards → list_columns → list_members dance first.

Configuration

Env var

Required

Default

Purpose

WEEEK_API_TOKEN

to call tools

—

Your WEEEK personal API token. The server starts and lists its tools without it, but any tool call fails until it is set.

WEEEK_API_BASE_URL

https://api.weeek.net/public/v1

Override for self-hosted / regional hosts.

WEEEK_TIMEOUT_MS

30000

Per-request timeout.

WEEEK_ATTACH_DIR

the server's working directory

Directory weeek_attach_file may read from (see Safety).

WEEEK_ATTACH_MAX_BYTES

10485760 (10 MB)

Max attachable file size.

Safety

This server is driven by an LLM that can read untrusted content (task text, web pages), so the two riskiest tools are guarded:

weeek_attach_file only reads files inside an allowed directory (its subfolders included). By default that's the server's working directory — so it works with no setup for local files, while paths outside it (/etc/passwd, ~/.ssh, .. traversal, symlinks that escape) are refused. Set WEEEK_ATTACH_DIR to point the jail somewhere specific or lock it down further. No special folder is required.

weeek_delete_task is permanent and requires an explicit confirm: true; to merely close a task use weeek_complete_task.

Install

Configuration

Environment variables

WEEEK_API_TOKENrequiredsecret

WEEEK personal API token (WEEEK → Settings → API)

WEEEK_API_BASE_URL

Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)

WEEEK_TIMEOUT_MS

Per-request timeout in ms (default 30000)

WEEEK_ATTACH_DIR

Directory weeek_attach_file may read from (default: the server's working directory)

WEEEK_ATTACH_MAX_BYTES

Max attachable file size in bytes (default 10485760)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<YOUR_WEEEK_API_TOKEN>",
        "WEEEK_API_BASE_URL": "<YOUR_WEEEK_API_BASE_URL>",
        "WEEEK_TIMEOUT_MS": "<YOUR_WEEEK_TIMEOUT_MS>",
        "WEEEK_ATTACH_DIR": "<YOUR_WEEEK_ATTACH_DIR>",
        "WEEEK_ATTACH_MAX_BYTES": "<YOUR_WEEEK_ATTACH_MAX_BYTES>"
      }
    }
  }
}

WEEEK (smart)

io.github.IlyaIvanchikov/weeek-mcp-smart — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚠️ Limitations

Topics

weeek-mcp-smart

Install (Claude Code / Cursor)

Install (Claude Desktop, one click)

Get a token

Configuration

Safety

Tools

Author

Install

Configuration