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.

Install (Claude Code / Cursor)

Terminal

claude mcp add weeek -s user -- npx -y weeek-mcp-smart
# then set WEEEK_API_TOKEN in the generated config

Install (Claude Desktop, one click)

⬇ Download the latest .mcpb, then open it in Claude Desktop (Settings → Extensions → install from file). You'll be prompted for your WEEEK API token — it's stored in your OS keychain.

All releases: https://github.com/IlyaIvanchikov/weeek-mcp/releases

Get a token

WEEEK → Settings → API → generate a personal token.

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`	no	`https://api.weeek.net/public/v1`	Override for self-hosted / regional hosts.
`WEEEK_TIMEOUT_MS`	no	`30000`	Per-request timeout.
`WEEEK_ATTACH_DIR`	no	the server's working directory	Directory `weeek_attach_file` may read from (see Safety).
`WEEEK_ATTACH_MAX_BYTES`	no	`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.

Tools

Reads: weeek_version, weeek_list_projects, weeek_list_tasks, weeek_get_task. Writes: weeek_create_task, weeek_create_tasks, weeek_update_task, weeek_move_task, weeek_complete_task, weeek_attach_file, weeek_delete_task.

Author

Ilya Ivanchikov — GitHub · LinkedIn · Telegram · Channel