Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
Complete OneNote MCP Server for Claude Desktop - Access your entire OneNote knowledge base through AI with robust authentication and full API support
Saved setup from 48 min ago
Will it work on macOS?
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/purpleslurple/onenote-mcp-server.git cd onenote-mcp-server
Python >=3.10
brew install uv
uv sync
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# or with Homebrew
brew install uv
git clone https://github.com/yourusername/onenote-mcp-server.git
cd onenote-mcp-server
# Create virtual environment and install dependencies
uv sync
You need to create an Azure app to access OneNote. Don't worry, it's free and takes 5 minutes:
https://login.microsoftonline.com/common/oauth2/nativeclientStill in your Azure app:
Notes.Read - Read OneNote notebooksNotes.ReadWrite - Create/modify OneNote content (optional but recommended)User.Read - Read user profileEdit your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json
Add this configuration (replace /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather with your actual path):
Basic configuration:
{
"mcpServers": {
"onenote": {
"command": "uv",
"args": [
"--directory", "/FULL/PATH/TO/onenote-mcp-server",
"run", "python", "onenote_mcp_server.py"
],
"env": {
"AZURE_CLIENT_ID": "your-azure-client-id-here"
}
}
}
}
With explicit token caching control:
{
"mcpServers": {
"onenote": {
"command": "uv",
"args": [
"--directory", "/FULL/PATH/TO/onenote-mcp-server",
"run", "python", "onenote_mcp_server.py"
],
"env": {
"AZURE_CLIENT_ID": "your-azure-client-id-here",
"ONENOTE_CACHE_TOKENS": "true"
}
}
}
}
Replace /FULL/PATH/TO/onenote-mcp-server with the actual path to this project.
Completely quit and restart Claude Desktop. You should see OneNote tools in the 🔨 menu.
No reports for macOS yet.
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.