基本能力
产品定位
NotePlan MCP 服务是一个连接 Claude Desktop 和 NotePlan 的中间件，旨在通过 Claude 对话直接管理和操作 NotePlan 笔记。
核心功能
- 读取笔记：获取所有笔记、按 ID 获取特定笔记或从特定文件夹获取笔记
- 搜索功能：在所有笔记中进行全文搜索
- 创建笔记：创建带有标题、内容和文件夹组织的新笔记
- 每日笔记：创建和管理带有自动日期格式的每日笔记
- 更新笔记：修改现有笔记的标题和内容
- 文件夹组织：按文件夹组织和筛选笔记
适用场景
- 通过 Claude 对话快速访问和管理 NotePlan 笔记
- 在 Claude 中直接创建和更新笔记
- 搜索和组织大量笔记内容
工具列表
| 工具 | 描述 | 参数 |
|---|---|---|
get_notes | 从 NotePlan 获取所有笔记 | 无 |
get_note_by_id | 按 ID 获取特定笔记 | id（必需） |
search_notes | 按查询搜索笔记 | query（必需） |
get_notes_by_folder | 从文件夹获取笔记 | folder（必需） |
create_note | 创建新笔记 | title（必需），content，folder |
create_daily_note | 创建每日笔记 | date（YYYY-MM-DD），content |
update_note | 更新现有笔记 | id（必需），title，content |
使用教程
使用依赖
- 确保已安装 Node.js 和 npm
安装教程
选项1：从 GitHub 克隆
git clone https://github.com/bscott/noteplan-mcp.git
cd noteplan-mcp
npm install选项2：作为 NPM 包安装（即将推出）
npm install -g noteplan-mcp快速开始
- 安装依赖：
npm install- 构建项目：
npm run build- 测试服务器：
npm start您应该看到："NotePlan MCP server running on stdio"
- 配置 Claude Desktop（见下方详细设置）
Claude Desktop 配置
- 找到您的配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json
- 添加 NotePlan MCP 服务器配置：
{
"mcpServers": {
"noteplan": {
"command": "node",
"args": ["/absolute/path/to/noteplan-mcp/build/index.js"],
"cwd": "/absolute/path/to/noteplan-mcp"
}
}
}注意：将 /absolute/path/to/noteplan-mcp 替换为实际路径
- 完全重启 Claude Desktop
调试方式
- 手动测试服务器：
cd /path/to/noteplan-mcp
npm run build
npm start- 使用 MCP 检查器进行调试：
npm run inspector- 检查 Claude Desktop 日志中的连接状态
- 在 Claude 中尝试简单命令："你能显示我的笔记吗？"