onenote MCP Server

Use This MCP server To

Search all my notebooks at once Pull up a note I wrote a while ago Add a new page to a notebook Summarise a long set of notes Find which notebook holds a topic Read a page's full contents in chat

README

OneNote MCP Server

A Model Context Protocol (MCP) server implementation that enables AI language models like Claude and other LLMs to interact with Microsoft OneNote.

This project is based on azure-onenote-mcp-server by Zubeid Hendricks, with modifications to simplify authentication and improve usability.

What Does This Do?

This server allows AI assistants to:

Access your OneNote notebooks, sections, and pages
Create new pages in your notebooks
Search through your notes
Read complete note content, including HTML formatting and text
Analyze and summarize your notes directly

All of this happens directly through the AI interface without you having to switch contexts.

Using with AI Assistants

Setup for Cursor

Clone this repository and follow the installation steps below
Start the MCP server: npm start
Register the server in Cursor:
- Open Cursor preferences (Cmd+, on Mac or Ctrl+, on Windows)
- Go to the "MCP" tab
- Add a new MCP server with these settings:
  - Name: onenote
  - Command: node
  - Args: ["/path/to/your/onenote-mcp.mjs"] (use absolute path)
Here's the complete JSON configuration example:
```
{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": ["/absolute/path/to/your/onenote-mcp.mjs"],
      "env": {}
    }
  }
}
```
Restart Cursor
In Cursor, you can now interact with your OneNote data using natural language:

Can you show me my OneNote notebooks?
Create a new page in my first notebook with a summary of this conversation
Find notes related to "project planning" in my OneNote

The first time you ask about OneNote, the AI will guide you through the authentication process.

Setup for Claude Desktop (or other MCP-compatible assistants)

onenote-mcp FAQ

Can I use this to search across all my notebooks?

Yes — you can search everything at once rather than opening each notebook.

Do I need a Microsoft account?

Yes, an active account with access to the OneNote content you want to reach.

Can it create notes as well as read them?

Yes — you can add new pages as well as search and read existing ones.

Which apps does it work with?

It is documented for Claude Desktop and Cursor.

How hard is it to set up?

You need Node installed and to run it yourself first, so expect a technical setup.