WEEEK (smart) MCP server

weeek-mcp-smart

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

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

No listprojects → listboards → listcolumns → listmembers dance first.

<!-- DEMO: drop a gif/screenshot here — an agent creating a task by name in one call. Your PROMOTE.md calls this the biggest single stars lever. Suggested: -->

Install (Claude Code / Cursor)

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

Safety

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

• weeekattachfile 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 WEEEKATTACHDIR to point the jail somewhere specific or lock it down further. No special folder is required.
• weeekdeletetask is permanent and requires an explicit confirm: true; to merely close a task use weeekcompletetask.

Tools

Reads: weeekversion, weeeklistprojects, weeeklisttasks, weeekgettask. Writes: weeekcreatetask, weeekcreatetasks, weeekupdatetask, weeekmovetask, weeekcompletetask, weeekattachfile, weeekdelete_task.

Author

Ilya Ivanchikov — GitHub · LinkedIn · Telegram · Channel