把待办清单接入ClaudeMindwtr MCP Server实战教程让AI读懂你的任务【免费下载链接】MindwtrGet tasks and ideas out of your head. A free GTD to-do app for desktop and mobile. Works offline, no account needed项目地址: https://gitcode.com/gh_mirrors/mi/MindwtrMindwtr 是一款免费、离线可用、无需注册账号的 GTD 待办应用支持桌面端与移动端。它的 MCP Server模型上下文协议服务器可以把你的待办数据直接喂给 Claude 等 AI 助手让 AI 帮你查任务、建任务、完成任务。本教程面向新手带你用不到 10 分钟把待办清单接入 Claude。一、Mindwtr 和 MCP Server 是什么先认识主角。Mindwtr 的数据存储在本地 SQLite 数据库mindwtr.db中所有待办、项目、区域Area、上下文Context都在其中MCPModel Context Protocol模型上下文协议是 AI 助手连接外部工具和数据源的标准协议。简单来说Mindwtr MCP Server就是一个翻译官架在 Claude 和你本地的待办数据之间Claude 通过它调用mindwtr_list_tasks、mindwtr_add_task等工具Tools数据全程留在你电脑上AI 只看到它请求的结果服务器源码位于 apps/mcp-server/src/index.ts官方说明文档在 apps/mcp-server/README.md。二、接入后 AI 能帮你做什么MCP Server 提供了一整套任务管理工具覆盖 GTD 工作流的主要环节能力对应工具示例问法查询任务mindwtr_list_tasks列出我明天到期的任务查看详情mindwtr_get_task看下这个任务的上下文和截止日期新建任务mindwtr_add_task帮我加一条任务明早 9 点给妈妈打电话完成任务mindwtr_complete_task把那个护照检查标记为完成管理项目mindwtr_list_projects/mindwtr_add_project我有哪些进行中的项目管理区域与联系人mindwtr_list_areas/mindwtr_list_people我的工作区域有哪些任务任务支持截止日期、优先级、上下文标签、重复规则RRULE、清单Checklist等丰富字段AI 解析下周三下午 3 点开会 #工作 办公室这类自然语言后能直接生成结构化任务。三、准备工作找到你的数据库MCP Server 默认直连桌面版的本地数据库。打开Settings → Sync → Local Data可以看到确切路径常见位置为Linux~/.local/share/mindwtr/mindwtr.dbmacOS~/Library/Application Support/mindwtr/data/mindwtr.dbWindows%APPDATA%\mindwtr\data\mindwtr.db如果不想手动填路径直接省略--db参数也可以——Server 会自动搜索上述默认位置详见 apps/mcp-server/README.md。四、一键配置把 Mindwtr 接入 Claude Desktop1. 无需克隆仓库直接安装npm 上的mindwtr-mcp包已经发布Claude Desktop 会用它自动拉起 Server{ mcpServers: { mindwtr: { command: npx, args: [ -y, mindwtr-mcp, --db, ~/.local/share/mindwtr/mindwtr.db ] } } }macOS 配置文件~/Library/Application Support/Claude/claude_desktop_config.jsonWindows 配置文件%APPDATA%\Claude\claude_desktop_config.json2. 保存后完全退出并重启 Claude Desktop重启后在对话框中就会出现 Mindwtr 的工具图标。试着问一句我收件箱里有什么任务——如果 AI 列出了你的任务列表接入就成功了 ✅小贴士默认是只读模式AI 只能查不能改。想让它帮你建任务、完成任务在args数组中加上--write即可。五、更省事的方式桌面版内置 MCP从 1.3.4 版本起Mindwtr 桌面端内置了 MCP 服务器完全不需要单独安装运行时打开Settings → Integrations → MCP开启开关默认关闭且只读勾选Allow changes允许 AI 创建、编辑、删除任务复制连接信息http://127.0.0.1:8722/mcp和 Bearer Token 到你的 AI 客户端内置 Server 与桌面应用共享同一套任务操作逻辑最小化到托盘时依然保持运行。适合不想碰命令行的用户。六、其他 MCP 客户端怎么接不止 Claude任何支持 stdio 的 MCP 客户端都能用Claude Codeclaude mcp add mindwtr -- bun /path/to/Mindwtr/apps/mcp-server/src/cli.ts --db /path/to/mindwtr.db --writeOpenAI Codex在~/.codex/config.toml中添加[mcp_servers.mindwtr]段Gemini CLIgemini mcp add mindwtr bun cli.ts路径 --db /path/to/mindwtr.db --write如果你搭建了自托管的 Mindwtr Cloudapps/cloud/还可以用 Cloud 模式传--cloud-url和--cloud-token两个参数即可适合多设备用户。七、安全须知三个必须知道的原则默认只读不传--write时AI 无法修改你的任务数据这是最安全的起步姿势Token 要保密内置 MCP 的 Bearer Token 泄露等于交出数据修改权复制后妥善保管重新生成会使旧客户端断开数据会发送给 AI 提供方AI 客户端能读取暴露的 Mindwtr 数据并发送到其服务方敏感内容请自行权衡写入操作走 packages/core/ 共享的核心存储层与桌面应用执行相同的业务规则校验不会出现 AI乱写数据的情况。八、常见问题速查QClaude 里看不到 Mindwtr 工具A确认配置文件路径正确、JSON 语法无误并完全重启 Claude Desktop。用--db时注意路径要真实存在。Qcommand not found: mindwtr-mcpA这是用npx配置时的正常现象由 npx 自动处理若从源码运行请用bun run mindwtr:mcp -- --db 路径而不是全局命令。QAI 完成了一条任务但显示超时A超时写入可能实际已生效先查一下任务状态再重试避免重复操作。写在最后用一条配置文件你的待办清单就变成了 AI 的第二大脑早上让 Claude 汇总今日待办睡前让它把收件箱里的碎片想法整理成任务。Mindwtr 免费、开源、本地优先MCP Server 让你在不牺牲数据主权的前提下享受 AI 自动化。现在就试试吧 【免费下载链接】MindwtrGet tasks and ideas out of your head. A free GTD to-do app for desktop and mobile. Works offline, no account needed项目地址: https://gitcode.com/gh_mirrors/mi/Mindwtr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考