Onenote Mcp Server

OneNote MCP Server A Model Context Protocol (MCP) server for Microsoft OneNote that enables reading and creating notebooks, sections, and pages through Claude Desktop or any MCP-compatible client.

Features 🔐 Secure authentication via Microsoft Device Code flow 📚 List all OneNote notebooks 📑 Browse sections within notebooks 📄 View pages in sections ✍️ Create new notebooks, sections, and pages 💾 Token caching for seamless re-authentication 🔧 Full MCP protocol implementation Prerequisites Node.js 14.0.0 or higher Microsoft Azure AD app registration with Graph API permissions Claude Desktop (or any MCP-compatible client) Quick Start Clone the repository: bash git clone https://github.com/YOUR_USERNAME/onenote-mcp-server.git cd onenote-mcp-server Install dependencies: bash npm install Set up Azure AD app registration (see Setup section below) Configure Claude Desktop (see Configuration section below) Setup

1. Create Azure AD App Registration

Go to Azure Portal Navigate to Azure Active Directory → App registrations → New registration Name your app (e.g., "OneNote MCP Server") Select "Accounts in any organizational directory and personal Microsoft accounts" Set redirect URI to "Public client/native" with value: https://login.microsoftonline.com/common/oauth2/nativeclient After creation, note the Application (client) ID

1. Configure API Permissions

In your app registration, go to API permissions Add the following Microsoft Graph delegated permissions: Notes.Read Notes.Create Notes.ReadWrite User.Read Grant admin consent if required

1. Configure Claude Desktop

Add the following to your Claude Desktop configuration file:

Windows: %APPDATA%\Claude\claudedesktopconfig.json macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json Linux: ~/.config/Claude/claudedesktopconfig.json

json { "mcpServers": { "onenote": { "command": "node", "args": ["/path/to/onenote-mcp-server/server.js"], "env": { "AZURECLIENTID": "your-azure-client-id-here" } } } } Replace /path/to/onenote-mcp-server/ with the actual path to your cloned repository.

Usage Once configured, you can interact with OneNote through Claude Desktop:

"List my OneNote notebooks" "Create a new notebook called 'My Ideas'" "Show me the sections in notebook 'Work Notes'" "Create a page titled 'Meeting Notes' in section 'January 2024'" "Read the content of page 'Project Plan'" API Documentation Tools onenote-read Read OneNote content (notebooks, sections, pages).

Parameters:

type: Operation type listnotebooks: List all notebooks listsections: List sections in a notebook listpages: List pages in a section readcontent: Read page content notebookId: Required for listsections sectionId: Required for listpages pageId: Required for read_content onenote-create Create OneNote content (notebooks, sections, pages).

Parameters:

type: Operation type createnotebook: Create a new notebook createsection: Create a new section createpage: Create a new page displayName: Required for notebooks and sections notebookId: Required for createsection sectionId: Required for createpage title: Required for pages content: HTML content for pages (optional) Troubleshooting Authentication Issues Ensure your Azure Client ID is correct Check that all required permissions are granted Delete .mcp-onenote-cache.json to force re-authentication Connection Issues Check Claude Desktop logs for error messages Verify the server path in your configuration Ensure Node.js is installed and accessible Common Errors MODULENOT_FOUND: Run npm install to install dependencies Invalid grant: Delete the token cache file and re-authenticate Permission denied: Check Azure AD permissions Security Never commit your Azure Client ID to version control The .mcp-onenote-cache.json file contains sensitive tokens - it's automatically excluded via .gitignore Use environment variables or Claude Desktop's configuration for credentials Contributing Fork the repository Create a feature branch (git checkout -b feature/amazing-feature) Commit your changes (git commit -m 'Add amazing feature') Push to the branch (git push origin feature/amazing-feature) Open a Pull Request License This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments Microsoft Graph API for OneNote integration Claude Desktop for MCP support The Model Context Protocol community Support For issues and questions:

Open an issue on GitHub Check the MCP documentation Review Microsoft Graph API documentation

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: FRESHSK
• Source: FRESHSK/onenote-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.