Onenote MCP server

Connect Onenote to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Onenote MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list notebooks tool in Onenote
  • Use the copy content tool in Onenote
  • Use the search pages tool in Onenote
  • Use the delete page tool in Onenote
  • Use the create page tool in Onenote
  • Use the list pages tool in Onenote

Supported Tools

list_notebooks

List Notebooks

List all OneNote notebooks accessible by the authenticated user. Supports filtering, sorting, and pagination via OData query parameters.

copy_content

Copy Content

Copy a OneNote notebook, section, or page to another location. Supports copying across notebooks, section groups, users, groups, and SharePoint sites. The copy operation is asynchronous and returns an operation status.

search_pages

Search Pages

Search OneNote pages accessible by the authenticated user. Searches page titles and can be scoped to a section for accounts with many sections.

delete_page

Delete Page

Permanently delete a OneNote page. This action cannot be undone.

create_page

Create Page

Create a new OneNote page in a section. The page body is provided as HTML. You can include a title, text, images (via public URLs), and other supported HTML elements.

list_pages

List Pages

List all pages within a OneNote section. Returns page metadata including title, creation time, and ordering. Supports filtering, sorting, and pagination.

list_section_groups

List Section Groups

List all section groups within a OneNote notebook. Section groups provide an additional level of hierarchy for organizing sections.

create_section_group

Create Section Group

Create a new section group for organizing sections. Can be created directly in a notebook or nested inside another section group.

update_page_content

Update Page Content

Update the content of an existing OneNote page using PATCH operations. Supports appending, replacing, inserting, prepending, and deleting content on specific page elements identified by their element IDs.

list_sections

List Sections

List all sections within a OneNote notebook. Supports filtering, sorting, and pagination.

create_notebook

Create Notebook

Create a new OneNote notebook with the specified name. The notebook is created in the authenticated user's default OneDrive location.

create_section

Create Section

Create a new section inside a OneNote notebook or section group. Provide either a **notebookId** or a **sectionGroupId** to specify the parent container.

get_notebook

Get Notebook

Retrieve details of a specific OneNote notebook by its ID, including creation date, sharing status, and modification metadata.

get_page

Get Page

Retrieve a OneNote page's metadata and optionally its HTML content or a short text preview. Use **includeContent** to fetch the full HTML body, or **includePreview** for a text snippet (up to 300 characters).

Connect Onenote to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Onenote in Metorial. In your Metorial portal, enable the Onenote MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Onenote tools.

Run Onenote through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Onenote and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Onenote tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Onenote

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Help Scout

Manage customer support conversations, customers, and knowledge base content. Create, update, assign, and close conversations across shared mailboxes. Add replies, notes, and attachments to conversation threads. Create and manage customer profiles with contact details and custom properties. Organize customers into companies/organizations. Manage tags, teams, users, and automated workflows. Create and update knowledge base articles, collections, and categories via the Docs API. Access support reporting including conversation volume, response times, user productivity, and customer satisfaction ratings. Configure webhooks to receive real-time notifications on conversation, customer, and organization changes.

Fireflies

Record, transcribe, and analyze meeting conversations from platforms like Zoom, Google Meet, and Webex. Retrieve, search, and manage meeting transcripts with AI-generated summaries, action items, sentiment analysis, and keywords. Upload audio files for transcription. Ask questions about meetings using the AskFred AI assistant. Add a bot to live meetings for automatic recording, pause and resume recordings, and create live action items or soundbites. Manage users and teams, organize meetings into channels, and query contacts.

Freshdesk

Manage customer support tickets, contacts, companies, and agents. Create, update, filter, merge, and delete support tickets with custom fields, tags, priorities, and assignments. Add replies, notes, and forward emails on ticket conversations. Manage contacts and companies with search, filter, import, and export capabilities. Maintain a knowledge base of articles organized in categories and folders. Run community discussion forums with topics and comments. Track time entries on tickets, configure SLA policies, and set up automation rules with webhook triggers. Manage canned response templates, custom objects, email mailboxes, collaboration threads, and agent groups with auto-assignment. Send outbound WhatsApp messages and handle satisfaction surveys and ratings. Support field service management with service tasks and technician scheduling.

Zendesk

Manage Zendesk Support tickets, ticket comments, users, organizations, Help Center articles, ticket views, groups, ticket fields, and macros. Create, update, resolve, and delete support tickets with assignments, priorities, tags, comments, and custom fields. Search across tickets, users, groups, and organizations, and inspect Help Center categories and sections before managing articles.

Technical notes for Onenote

Create, read, update, and organize OneNote notebooks, sections, section groups, and pages. Create pages with rich HTML content including images, video, audio, and embedded files. Update page content using targeted patch operations. Copy notebooks, sections, and pages across user, group, and SharePoint site locations. Search notes with full-text search and OCR on images. Retrieve page previews and structured notebook hierarchies. Access personal, shared, group, and SharePoint site-hosted notebooks.

Frequently asked questions

Common questions about connecting Onenote to AI agents with Metorial.

  1. How many tools does the Onenote MCP server have?
    The Onenote MCP server exposes 14 tools, including List Notebooks, Copy Content, Search Pages. Each one is governed and traced through Metorial.
  2. Onenote exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Onenote MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Onenote and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Onenote MCP server yourself or use the hosted gateway.

Connect Onenote to production AI agents

See how Metorial gives your team governed access to Onenote, with tracing and security controls built in.