SkillFoxx

Type a name, a task or a service

WEEEK MCP by names, not IDs

weeek-mcp-smart

A WEEEK MCP server creates a task from project, column and assignee names in one call, no chain of lookups for their IDs

MCP server

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • Creates and changes tasks in the WEEEK workspace using a broadly scoped token
  • The API token grants access to the whole workspace, not just tasks
All reasons and checks
Russian stack

ilyaivanchikov/weeek-mcpAuthor:IlyaIvanchikov

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/weeek-mcp-smart

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal

claude mcp add --transport stdio --env 'WEEEK_API_TOKEN=<your WEEEK_API_TOKEN>' weeek-mcp-smart -- npx -y weeek-mcp-smart@0.4.4

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"weeek-mcp-smart","type":"stdio","command":"npx","args":["-y","weeek-mcp-smart@0.4.4"],"env":{"WEEEK_API_TOKEN":"<your WEEEK_API_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "weeek-mcp-smart": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add weeek-mcp-smart --env 'WEEEK_API_TOKEN=<your WEEEK_API_TOKEN>' -- npx -y weeek-mcp-smart@0.4.4

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.weeek-mcp-smart]
command = "npx"
args = ["-y", "weeek-mcp-smart@0.4.4"]
env = { WEEEK_API_TOKEN = "<your WEEEK_API_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "weeek-mcp-smart": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "environment": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "weeek-mcp-smart": {
      "command": "npx",
      "args": [
        "-y",
        "weeek-mcp-smart@0.4.4"
      ],
      "env": {
        "WEEEK_API_TOKEN": "<your WEEEK_API_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WEEEK_API_TOKENsecret, required
WEEEK personal API token (WEEEK → Settings → API)
WEEEK_API_BASE_URLoptional
Override API base for self-hosted / regional hosts (default https://api.weeek.net/public/v1)
WEEEK_TIMEOUT_MSoptional
Per-request timeout in ms (default 30000)
WEEEK_ATTACH_DIRoptional
Directory weeek_attach_file may read from (default: the server's working directory)
WEEEK_ATTACH_MAX_BYTESoptional
Max attachable file size in bytes (default 10485760)

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 04dc4c7.

Text for your agent

Add the server with claude mcp add weeek -s user -- npx -y weeek-mcp-smart, then set the WEEEK_API_TOKEN variable from WEEEK → Settings → API.

Other ways from the author
claude mcp add weeek -s user -- npx -y weeek-mcp-smart

The README's command; WEEEK_API_TOKEN is then set in the generated config.

This is third-party code. Review the repository files before installing.

What it does

Normally, creating a task via the WEEEK API means first looking up the project, board, column and assignee ids with four separate calls. This server accepts human names directly in one weeek_create_task call: project, column, assignee and a free-form due date like next friday, resolving them to the right ids itself. It installs as a regular npm package for Claude Code and Cursor, or as a one-click .mcpb extension for Claude Desktop, where the token is kept in the OS keychain rather than a plain-text config.

Who it is for. For people who want to create WEEEK tasks in one phrase without first figuring out numeric project and column ids.

Good fit when

  • You want to create a task by project and column name rather than id
  • You use Claude Desktop and want a one-click .mcpb install
  • You want a due date in free form, like next friday

Not a fit when

  • You need access to WEEEK's knowledge base or CRM parts, the server is focused on tasks
  • You need full coverage of every WEEEK API operation rather than convenient task creation

Example request

Create a task Ship the release in the Marketing project, column In Progress, assignee Ilya, due next friday

Limitations

The server is focused on tasks and creating them by name, not on full WEEEK API coverage. It needs a personal WEEEK API token from workspace settings.

How to disable. Remove the weeek server from your MCP client configuration, or remove the .mcpb extension in Claude Desktop via Settings → Extensions.

MCP

Transport
stdio
Authentication
API key
Environment variables
WEEEK_API_TOKEN
required, secret		A personal WEEEK token from the Settings → API section.

Security check

  • Creates and changes tasks in the WEEEK workspace using a broadly scoped token
  • The API token grants access to the whole workspace, not just tasks

README in short

The English README pitches the server as the only one-click WEEEK MCP, where a task is created by names rather than ids, with a weeek_create_task example. It shows two install paths: npx for Claude Code and Cursor, and .mcpb for Claude Desktop with keychain token storage, plus an environment variable table.

FAQ

How is this different from other WEEEK MCP servers?

The main selling point, per the author, is that a task is created from project, column and assignee names in one call, skipping the list_projects, list_boards, list_columns and list_members lookups.

Where is the token stored with the .mcpb install?

In the OS keychain, rather than a plain-text config file.

Official

A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes

MCP serverMedium risk46.5K
Editors’ pick

A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more

CLIHigh risk31.2K
Editors’ pick

Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server

CLIMedium riskNo VPN needed30.1K
Editors’ pick

A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI

MCP serverMedium risk28.1K
Foxx AIWEEEK MCP by names, not IDs

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.