Notion Local MCP

本地MCP概念

读取Notion桌面应用程序的本地SQLite缓存，在Claude中快速搜索和查看Notion文档的MCP服务器。

快速启动（Quick Start）

1.必备条件

• 安装
• Notion桌面应用程序 安装和登录

2.自动设置

在终端上运行以下命令时自动设置：

npx @lulee/notion-local-mcp setup

🔧 Notion Local MCP Setup
========================================

🔍 Operating system: macOS
✅ Notion found: /Users/user/Library/Application Support/Notion/notion.db

Which apps do you want to configure?

  1. Claude Desktop Chat
  2. Claude Code (CLI)
  3. Both (recommended)

Enter choice [1-3, default: 3]: 3

========================================

✅ Claude Desktop: Successfully configured notion-local for Claude Desktop
✅ Claude Code: Successfully configured notion-local for Claude Code

🎉 Setup complete!

Please restart your Claude app to apply the changes.

3.重新启动应用程序

重新启动Claude Desktop或Claude Code即可使用。

结束！

______________________________________________________________________

通知API MCP与通知本地

建议使用：

• 搜索/查询 → notion-local （快速，不使用Notion AI，可离线）
• 创建/修改 → Notion API MCP （写入需要服务器API）

______________________________________________________________________

支持平台

参考：Notion是 不提供官方Linux桌面应用程序在.Linux中，只能在社区非正式构建（例如notion-app-electron）中工作。

______________________________________________________________________

MCP工具

通知_本地搜索

按关键字搜索页面

{
  query: string,          // 검색어 (필수)
  type?: "page" | "all",  // 검색 범위 (기본: page)
  limit?: number          // 최대 결과 수 (기본: 20)
}

notion_local_recent

最近修改的页面列表

{
  limit?: number,   // 최대 결과 수 (기본: 20)
  days?: number     // 며칠 이내 (기본: 30)
}

通知_本地_页面

查看整个页面的内容

{
  pageId: string,   // 페이지 UUID (필수)
  depth?: number    // 중첩 블록 깊이 (기본: 3)
}

通知_本地_租金

浏览页面的上层

{
  pageId: string    // 페이지 UUID (필수)
}

通知_本地儿童

页面的子页面列表

{
  pageId: string,   // 페이지 UUID (필수)
  depth?: number    // 탐색 깊이 (기본: 2)
}

______________________________________________________________________

手动设置（高级）

如果无法自动设置，可以手动设置。

克劳德桌面聊天

~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "notion-local": {
      "command": "npx",
      "args": ["-y", "@lulee/notion-local-mcp"],
      "env": {
        "NOTION_DB_PATH": "/Users/YOUR_USERNAME/Library/Application Support/Notion/notion.db"
      }
    }
  }
}

克劳德代码

~/.claude.json:

{
  "mcpServers": {
    "notion-local": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@lulee/notion-local-mcp"],
      "env": {
        "NOTION_DB_PATH": "/Users/YOUR_USERNAME/Library/Application Support/Notion/notion.db"
      }
    }
  }
}

______________________________________________________________________

开发

要在本地开发，请：

git clone https://github.com/lulee/notion-local-mcp.git
cd notion-local-mcp
npm install
npm run build
npm run setup  # 로컬 빌드를 Claude에 연결

______________________________________________________________________

注意事项

• 只读：只读取本地缓存，不修改Notion数据。
• 需要Notion应用程序：必须安装Notion桌面应用程序才能存在缓存。
• 同步延迟：在同步Notion应用程序之前，可能不会反映最近的更改。

______________________________________________________________________

许可证

麻省理工学院