中文

MCP 接入指南

DueIsland · 让任意 AI 客户端管理你的提醒

DueIsland 内置本地 MCP 服务，任何支持 MCP 的 AI 客户端（Claude Code、Claude Desktop、Cursor、Codex、VS Code 等）都能创建、查询、修改、完成、延迟、删除你的提醒，改动实时同步。

开启

打开 DueIsland ▸ 设置 ▸ MCP 服务，打开开关。
复制设置页显示的地址与鉴权头（每台设备唯一，重置 token 后旧配置失效）。

通用连接信息

任何客户端只需这两项：

项	值
地址 URL	`http://127.0.0.1:<PORT>/mcp`
鉴权头 Header	`Authorization: Bearer <TOKEN>`
传输 Transport	Streamable HTTP

<PORT> 默认 51837；若被占用，服务会自动顺延到下一个可用端口，以设置页显示的地址为准。<TOKEN> 从设置页复制。

部分客户端配置示例

Claude Code

claude mcp add --transport http dueisland http://127.0.0.1:<PORT>/mcp \
  --header "Authorization: Bearer <TOKEN>"

验证：claude mcp list，或在会话里输入 /mcp。

Cursor

~/.cursor/mcp.json（全局）或项目内 .cursor/mcp.json：

{
  "mcpServers": {
    "dueisland": {
      "url": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

Claude Desktop

claude_desktop_config.json（设置 ▸ Developer ▸ Edit Config）：

{
  "mcpServers": {
    "dueisland": {
      "url": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

OpenAI Codex

桌面版（图形界面）最省事的是直接填「标头 / Headers」，不碰环境变量：

URL：http://127.0.0.1:<PORT>/mcp
标头键 Authorization，值 Bearer <TOKEN>
「Bearer 令牌环境变量」留空

CLI / config.toml：Codex 用环境变量名传 token（不是明文）：

export DUEISLAND_TOKEN="<TOKEN>"

[mcp_servers.dueisland]
url = "http://127.0.0.1:<PORT>/mcp"
bearer_token_env_var = "DUEISLAND_TOKEN"

VS Code

.vscode/mcp.json（注意外层是 servers 且需 type）：

{
  "servers": {
    "dueisland": {
      "type": "http",
      "url": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

可用工具

工具	参数	说明
`create_reminder`	`title`（必填）、`kind`(timer\|reminder)、`minutes`、`at`(ISO8601)、`recur`(none\|daily\|weekdays\|weekly\|monthly)、`notes`	建提醒/计时器。省略 `kind` 时按 `at`→reminder、`minutes`→timer 推断。
`list_reminders`	`includeCompleted`(bool，默认 false)	列出提醒（含 id，供后续按 id 操作）。
`update_reminder`	`id`（必填）、`title`、`minutes`、`at`、`recur`、`notes`	部分更新——只改传入的字段。时间用 `at`（仅 reminder）或 `minutes` 二选一。编辑已完成条目会将其复活。
`complete_reminder`	`id`	标记完成。
`snooze_reminder`	`id`、`minutes`（默认 10）	延迟。
`delete_reminder`	`id`	删除。

问题反馈：hornjoystudio@gmail.com

English

MCP Setup Guide

DueIsland · Connect any AI client to your reminders

DueIsland ships with a built-in local MCP server, so any MCP-capable AI client (Claude Code, Claude Desktop, Cursor, Codex, VS Code, and more) can create, list, update, complete, snooze, and delete your reminders. Changes sync instantly.

Enable

Open DueIsland ▸ Settings ▸ MCP Server and turn on the switch.
Copy the URL and the auth header shown in Settings (unique per device; resetting the token invalidates old configs).

Universal connection info

Every client needs just these two values:

Field	Value
URL	`http://127.0.0.1:<PORT>/mcp`
Header	`Authorization: Bearer <TOKEN>`
Transport	Streamable HTTP

<PORT> defaults to 51837; if occupied, DueIsland automatically moves to the next free port — always use the URL shown in Settings. Copy <TOKEN> from Settings.

Example client configurations

Claude Code

claude mcp add --transport http dueisland http://127.0.0.1:<PORT>/mcp \
  --header "Authorization: Bearer <TOKEN>"

Verify with claude mcp list or /mcp inside a session.

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json in a project:

{
  "mcpServers": {
    "dueisland": {
      "url": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

Claude Desktop

claude_desktop_config.json (Settings ▸ Developer ▸ Edit Config):

{
  "mcpServers": {
    "dueisland": {
      "url": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

OpenAI Codex

Desktop app: fill in the “Headers” field directly — no environment variables needed:

URL: http://127.0.0.1:<PORT>/mcp
Header key Authorization, value Bearer <TOKEN>
Leave “Bearer token environment variable” empty

CLI / config.toml: Codex references the token via an environment variable name:

export DUEISLAND_TOKEN="<TOKEN>"

[mcp_servers.dueisland]
url = "http://127.0.0.1:<PORT>/mcp"
bearer_token_env_var = "DUEISLAND_TOKEN"

VS Code

.vscode/mcp.json (note the outer key is servers and type is required):

{
  "servers": {
    "dueisland": {
      "type": "http",
      "url": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

Available tools

Tool	Arguments	Description
`create_reminder`	`title` (required), `kind` (timer\|reminder), `minutes`, `at` (ISO8601), `recur` (none\|daily\|weekdays\|weekly\|monthly), `notes`	Create a reminder or timer. When `kind` is omitted it is inferred: `at`→reminder, `minutes`→timer.
`list_reminders`	`includeCompleted` (bool, default false)	List reminders with their ids for follow-up calls.
`update_reminder`	`id` (required), `title`, `minutes`, `at`, `recur`, `notes`	Partial update — only provided fields change. Time via `at` (reminder only) or `minutes`, not both. Editing a completed item reactivates it.
`complete_reminder`	`id`	Mark complete.
`snooze_reminder`	`id`, `minutes` (default 10)	Postpone.
`delete_reminder`	`id`	Delete.

Questions: hornjoystudio@gmail.com