开发者

基于 WeeklyPlanner 构建

你可以通过公开 API 访问任务、分组、偏好设置、用户资料和自动化能力。MCP 服务复用同一套接口边界，并提供 16 个原子化工具。

创建账号登录/settings

AI 助手可以调用同一套任务模型

list_tasks({ date_from, date_to })
update_task({ task_id, date, time_block })
delete_task_series({ series_id })

MCP 工具和公开 API 共享边界：默认隐藏循环模板，只暴露可见任务实例，避免 AI 破坏计划结构。

WeeklyPlanner API 和 MCP 对应的周视图任务
list_tasksupdate_taskdelete_task_series

REST API

当前已经提供 /api/v1 下的任务、分组、资料、设置、统计、订阅和 API 密钥等接口。

API 密钥与权限范围

你可以在设置页生成 API 密钥，并且只给它分配当前集成真正需要的权限范围。

MCP 服务

16 个原子化工具，每个工具说明都包含完整的数据字典。AI 会先读清楚每次调用可传什么、会回什么，再自行组合操作。

安全边界

应用登录仍然由 Supabase Auth 负责，API 密钥校验、权限范围和限流也已经收敛到统一入口。

快速开始

1. 先创建账号

先注册并登录，然后到设置页管理开发者访问能力。

2. 创建 API 密钥

在设置页生成 API 密钥，只勾选当前真正需要的权限范围，并马上保存。明文密钥只会显示一次。

3. 调用 API 或 MCP

把 API 密钥作为 Bearer Token 传入。MCP 请求还会额外带上 X-WeeklyPlanner-Source: mcp。

调用示例

读取任务

curl -X GET "https://weeklyplanner.cc/api/v1/tasks?date_from=2026-03-01&date_to=2026-03-31" \
  -H "Authorization: Bearer wp_your_api_key" \
  -H "Content-Type: application/json"

创建任务

curl -X POST "https://weeklyplanner.cc/api/v1/tasks" \
  -H "Authorization: Bearer wp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Prepare weekly review",
    "date": "2026-03-20",
    "time_block": "evening",
    "priority": "high"
  }'

MCP 快速开始

安装

npm install -g weeklyplanner-mcp

Claude Code

claude mcp add weeklyplanner -- npx -y weeklyplanner-mcp

# macOS / Linux
export WEEKLYPLANNER_API_URL="https://weeklyplanner.cc"
export WEEKLYPLANNER_API_KEY="wp_your_api_key"

# Windows PowerShell
$env:WEEKLYPLANNER_API_URL="https://weeklyplanner.cc"
$env:WEEKLYPLANNER_API_KEY="wp_your_api_key"

Claude Desktop

{
  "mcpServers": {
    "weeklyplanner": {
      "command": "npx",
      "args": ["-y", "weeklyplanner-mcp"],
      "env": {
        "WEEKLYPLANNER_API_URL": "https://weeklyplanner.cc",
        "WEEKLYPLANNER_API_KEY": "wp_your_api_key"
      }
    }
  }
}

配置完成后，问你的 AI：“列出我这周的任务”来验证连接。

原子化 MCP 组合

读取今天的完整任务上下文

调用 list_tasks 并传 { date: "YYYY-MM-DD" }。返回的是完整任务对象，AI 一次就能看到 time_block、notes、tags、recurrence_rule、defer_count 和 overdue_days。

不靠场景化工具也能改单任务

直接调用 update_task，只传你要改的字段，例如 { task_id, completed: true } 或 { task_id, date: "2026-03-29" }。

自行拼出更大的计划视角

组合 get_user_profile、get_settings、get_subscription、get_stats({ date_from, date_to }) 和带过滤条件的 list_tasks，而不是依赖预设的“周回顾”或“今日总结”工具。

当前可用的权限范围

每个集成尽量只给最小权限集合，避免把写权限放给不需要写入的工具。

tasks:readtasks:writegroups:readgroups:writestats:readsettings:readsettings:writeprofile:readprofile:write

核心接口

任务

支持任务列表、创建、更新、删除、批量更新和拖拽后的重排。

分组

支持分组名称、颜色、顺序管理，以及跨分组移动任务。

设置与资料

支持读取和更新视图偏好、语言、ADHD 模式和个人资料字段。

统计与订阅

支持读取聚合统计数据和订阅状态，方便仪表盘或 AI 工作流使用。

接口说明和示例会继续补充。产品内的支付与结账已经接入 Creem，但公共开发者接口暂时仍聚焦任务、设置、统计、订阅和 API 密钥。