MCP Wrike

mcp-wrike

用于Wrike项目管理的MCP（模型上下文协议）服务器。对任务、文件夹、空间和附件的完全CRUD支持，并具有用于引导的帐户发现功能。

特性

发现

• 发现_计数 --Bootstrap工具：识别经过身份验证的用户，枚举空间，列出具有工作流分配的顶级文件夹，对帐户级别和空间范围的工作流进行编目，并可选地包括自定义字段和项目类型

阅读

• 搜索任务 --按标题或状态搜索任务
• 获取任务 --获取详细的任务信息
• get_ask_comments --查看任务的评论/注释
• 获取任务附件 --列出任务附件
• get_task_full --完整视图：任务+评论+附件
• get_workflows --列出所有帐户级工作流及其自定义状态
• get_custom_fields --列出所有自定义字段定义
• get_custom_item_types --列出所有自定义项目类型定义
• list_folders --浏览Wrike文件夹/项目
• get_folder_tasks --列出文件夹中的任务（支持 recursive=true 包含子文件夹/项目任务）

写

• 创建任务 --使用标题、描述、状态、指定人员、日期、重要性、自定义字段和自定义项目类型创建任务
• update_task --更新任何任务字段，包括自定义字段
• 完成任务 --将任务标记为已完成
• 移动任务 --在文件夹之间移动任务（添加/删除父项）
• 删除任务 --永久删除任务
• 创建文件夹 --创建子文件夹
• 删除文件夹 --永久删除文件夹
• delete_space --永久删除空格
• 附件文件 --上传本地文件作为任务附件

安装

# Install from source
cd mcp-wrike
pip install -e .

配置

获取您的Wrike访问令牌

1. 首选https://www.wrike.com/frontend/apps/index.html#/api
2. 创建新的“永久访问令牌”
3. 复制令牌

存储令牌

选项1——系统钥匙链（推荐）：

wrike-auth store
# Enter your token when prompted

选项2——环境变量：

export WRIKE_ACCESS_TOKEN=your_token_here

检查配置

wrike-auth show

Claude代码集成

添加到您的 .claude/settings.local.json MCP配置：

{
  "mcpServers": {
    "wrike": {
      "command": "mcp-wrike"
    }
  }
}

或在 claude_desktop_config.json 对于Claude Desktop：

{
  "mcpServers": {
    "wrike": {
      "command": "mcp-wrike"
    }
  }
}

帐户发现（Bootstrap）

这 discover_account 该工具提供了Wrike帐户结构的全面视图。使用它来标识任务管理所需的文件夹ID、工作流状态ID、自定义字段和项目类型。

它发现了什么

• 认证用户 --姓名、电子邮件、联系人ID
• 空间 --所有具有访问类型和成员数的空间
• 每个空间的顶级文件夹 --仅筛选为直接子级（不是完整的递归树），工作流分配按名称解析
• 空间范围的工作流 --属于特定空间的工作流（不由帐户级工作流终结点返回）
• 帐户级工作流 --所有40多个具有自定义状态ID的共享工作流
• 自定义字段 （可选）--具有类型和允许值的字段定义
• 自定义项目类型 （可选）--任务类型定义（项目、任务、Bug、Spike、Epic等）

参数

工作流范围

Wrike工作流的范围可以是帐户级别或特定空间。这 discover_account 工具检查以下两项：

• 账户级别: GET /workflows --在所有空间中共享
• 空间范围: GET /spaces/{id}/workflows --属于特定空间

这很重要，因为文件夹的 workflowId 可能引用未出现在帐户级别列表中的空间范围工作流。

自定义字段

create_task 和 update_task 通过支持Wrike自定义字段 custom_fields 参数：

{
  "custom_fields": [
    {"id": "FIELD_ID", "value": "field value"}
  ]
}

使用 discover_account 随着 include_custom_fields=true 列出所有可用的字段ID，或直接查询Wrike API： GET /customfields.

自定义项目类型

任务可以在创建时通过以下方式分配自定义项目类型 custom_item_type_id 参数。创建后无法更改项目类型。

使用 discover_account 随着 include_item_types=true 列出可用类型。

使用示例

配置后，您可以询问Claude：

• “发现我的Wrike帐户结构”
• “搜索有关“部署”的活动任务”
• “在文件夹X中创建一个名为“修复错误”的任务”
• “将任务IEAABCD123标记为已完成”
• “将任务移动到工程文件夹”
• “将此规范文件附加到Wrike任务”
• “显示工程文件夹中的所有任务”
• “删除空的测试文件夹”

许可证

麻省理工学院