OneNote MCP Server

OneNote MCP 服务

Microsoft OneNote 的模型上下文协议（MCP）服务实现，可让 AI 大模型通过标准化接口与 OneNote 交互。

功能

笔记本管理

• 列出所有笔记本
• 创建新笔记本
• 获取笔记本详情
• 删除笔记本

分区管理

• 列出笔记本中的分区
• 创建新分区
• 获取分区详情
• 删除分区

页面管理

• 列出分区中的页面
• 使用 HTML 内容创建新页面
• 读取页面内容
• 更新页面内容
• 删除页面
• 搜索所有笔记本中的页面

安装

从 npm 安装（推荐）

npm install -g mcp-server-onenote

自 2025 年 4 月 27 日起，该软件包已发布到 npm 注册表。

运行软件包

安装后，可使用以下命令运行软件包：

mcp-server-onenote

或使用 npx：

npx mcp-server-onenote

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 OneNote 服务：

npx -y @smithery/cli install @modelcontextprotocol/server-onenote --client claude

从 GitHub 安装

npm install -g github:ZubeidHendricks/azure-onenote-mcp-server

配置

设置以下环境变量：

• AZURE_TENANT_ID：你的 Azure 租户 ID
• AZURE_CLIENT_ID：你的 Azure 应用程序（客户端）ID
• AZURE_CLIENT_SECRET：你的 Azure 客户端密钥

配合 MCP 客户端使用

将以下内容添加到 MCP 客户端配置中（例如 Claude Desktop）：

{
  "mcpServers": {
    "onenote": {
      "command": "mcp-server-onenote",
      "env": {
        "AZURE_TENANT_ID": "<YOUR_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Azure 应用注册

1. 前往 Azure Portal 并导航至“应用注册”
2. 创建新的注册
3. 添加 Microsoft Graph API 权限：
   • Notes.ReadWrite.All
   • Notes.Read.All
4. 创建客户端密钥
5. 复制租户 ID、客户端 ID 和客户端密钥以进行配置

开发

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Lint
npm run lint

# Run locally
npm start

贡献

有关如何为此代码库做出贡献的信息，请参阅 CONTRIBUTING.md。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件

更新日志

0.1.0 (2025-04-27)

• 首次发布
• 实现 OneNote 笔记本、分区和页面管理的核心功能
• 发布到 npm 注册表

0.1.1 (2025-04-27)

• 在 package.json 中添加可执行文件 bin
• 修复 npx 命令无法确定要运行的可执行文件的问题
• 更新 README，提供清晰的运行说明