monthlet

monthlet MCP 服务

通过 Claude Code、Claude Desktop 和其他 MCP 客户端使用 monthlet 知识库中的笔记。搜索和阅读笔记；如果你允许，也可以创建和编辑笔记。

MCP 服务在你电脑上的 monthlet 应用中运行。此代码库包含 MCP 客户端通过标准输入输出启动的小型桥接程序（monthlet-mcp.cjs）。该桥接程序通过 127.0.0.1 将每条消息转发给应用，不做其他操作。它不会向互联网发送任何内容。

要求

• 正在运行的 macOS 或 Windows 版 monthlet
• 已在 monthlet 中开启 MCP 服务：设置 > 连接器 > 发布到外部 Agent > 发布
• Node.js 18 或更高版本（桥接程序没有其他依赖）

如果 monthlet 未运行，或 MCP 服务已关闭，每次工具调用都会返回相应错误。

服务功能

发布后即可读取。写入、移动和重命名、删除功能在同一设置区域中各有独立开关，默认均为关闭。

开关	工具
发布（只读）	search_notes、list_notes、read_note、grep_notes、list_folders、list_files、get_backlinks、list_attachments、view_image、read_pdf、read_file、read_chart_data、read_sheet_range
允许写入	create_note、update_note、edit_note、update_tags、create_folder、create_sheet、apply_sheet_edits、add_attachment
允许移动和重命名	move_note、move_folder、rename_note、rename_folder
允许删除	delete_note、delete_folder、merge_notes（已删除的项目会移至系统废纸篓）

每个工具都带有 MCP 工具注释（readOnlyHint、destructiveHint），因此客户端可以在运行会更改笔记的工具前询问你。

安装

Claude Code 插件

从 Claude 插件目录安装 monthlet，或在 Claude Code 中从此代码库安装：

/plugin install monthlet --marketplace t27d/monthlet-mcp

该插件会运行 node ${CLAUDE_PLUGIN_ROOT}/monthlet-mcp.cjs。

手动配置 Claude Code

克隆此代码库，然后：

claude mcp add --scope user monthlet -- node /path/to/monthlet-mcp/monthlet-mcp.cjs

在 macOS 上，你也可以使用应用内的副本。monthlet 会在 设置 > 连接器 > 发布到外部 Agent > 设置 中显示准确的命令。

Claude Desktop 和其他客户端

添加一个使用 Node.js 运行此桥接程序的标准输入输出服务。在 Claude Desktop 的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "monthlet": {
      "command": "node",
      "args": ["/path/to/monthlet-mcp/monthlet-mcp.cjs"]
    }
  }
}

在 Windows 上，请使用转义反斜杠填写路径，例如 "C:\\Users\\you\\monthlet-mcp\\monthlet-mcp.cjs"。

连接方式

MCP 服务开启期间，monthlet 会在其用户数据文件夹中写入一个包含当前端口和访问令牌的连接文件，并在停止时删除该文件：

• macOS：~/Library/Application Support/monthlet/mcp-endpoint.json
• Windows：%APPDATA%\monthlet\mcp-endpoint.json；Microsoft Store 版本则使用 %LOCALAPPDATA%\Packages\t27d.monthlet_*\LocalCache\Roaming 内的相同路径

桥接程序每次连接时都会读取此文件，因此令牌不会进入客户端配置；在 monthlet 中重新生成令牌也无需更改客户端设置。

许可证

MIT。monthlet 本身不是开源软件；此代码库仅包含桥接程序。