Microsoft OneNote
Digital notebook for capturing and organizing notes, drawings, and information
Verdict
Common use cases
- Archive completed project notes to a central notebook
- Duplicate meeting agendas across team section groups
- Pull research pages into a shared brainstorm Space
- Consolidate scattered notes into one master section
- Mirror onboarding docs from HR notebook to new hire folders
Integration
- Vendor
- Microsoft OneNote
- Category
- productivity
- Auth
- OAUTH2
- Tools
- 50
- Composio slug
onenote
Tools
- Copy group section to section group
Copies a OneNote section from a Microsoft 365 group's notebook into another section group. Use this action when you need to duplicate an existing OneNote section that lives in a Microsoft 365 group's notebook into a different section group.
- Copy notebook in group
Copies a OneNote notebook to the Notebooks folder in the destination Documents library. The notebook is copied asynchronously. This action initiates the copy operation and returns a 202 Accepted response with an Operation-Location header. U
- Copy notebook in site
Copies a OneNote notebook to the destination site in the SharePoint documents library. Use this action when you need to duplicate a notebook within a SharePoint site, or copy it to a different site's documents library. The copied notebook's
- Copy section to notebook (site context)
Copies a OneNote section to a specific notebook within a SharePoint site. Use this action when you need to duplicate an existing OneNote section into a different notebook within the same SharePoint site. The operation is asynchronous and re
- Copy section to notebook (user)
Copies a OneNote section to a specific notebook for a specified user. Use this action when you need to duplicate an existing OneNote section into a different notebook under a specific user's account. The operation is asynchronous and return
- Copy section to section group (user)
Copies a OneNote section to a specific section group for a specified user. Use this action when you need to duplicate an existing OneNote section into a different section group under a specific user's account. The operation is asynchronous
- Copy site page to section
Copies a OneNote page from a SharePoint site to a destination section. Use this action when you need to duplicate a OneNote page into a different section within the same or a different SharePoint site's notebook. The operation is asynchrono
- Copy user page to section
Copy a OneNote page from a user's notebook to a specified section. Use this action when you need to duplicate a OneNote page into a different section within a user's Microsoft 365 account. This is an asynchronous operation that returns a 20
- Count notebook section group sections
Gets the count of OneNote sections within a section group in a user's notebook. Use this action when you need to quickly determine the number of sections in a section group without retrieving the full list of section objects. This is a read
- Count site notebook section group sections
Gets the count of sections within a OneNote section group in a SharePoint site notebook. Use this action when you need to quickly determine the number of sections in a section group without retrieving the full list of section objects. Micro
- Create group notebook
Creates a new OneNote notebook within a Microsoft 365 group. Use this action when you need to create a new notebook for storing notes within a specific Microsoft 365 group. The notebook will be owned by the specified group and accessible to
- Create group OneNote page
Creates a new OneNote page in the default section of the default notebook for a Microsoft 365 group. Use this action when you need to programmatically create a new page in a group's OneNote notebook. The page content must be provided as HTM
- Create OneNote page in section
Creates a new OneNote page in a specific section for the signed-in user. Use this action when you need to create a new page within a specific section of the user's OneNote notebook. The page content must be provided as HTML. The action cons
- Create section group in group notebook
Creates a new section group within a OneNote notebook that belongs to a Microsoft 365 group. Use this action when you need to organize sections inside a group notebook by creating a new top-level section group to hold related sections toget
- Create section in section group
Creates a new OneNote section within a specified section group of a Microsoft 365 group. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy within a group. The section name must b
- Create section in site notebook
Creates a new OneNote section within a specified notebook in a SharePoint site. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a SharePoint site. The section name must be uniqu
- Create section in user notebook
Creates a new OneNote section within a specified notebook for a specific user. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a specific user. The section name must be unique w
- Create section in user section group
Creates a new OneNote section within a specified section group for a specific user. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy for a specific user's notebook. The section
- Create section in user's section group
Creates a new OneNote section within a specified section group of a notebook for the signed-in user. Use this action when you need to add a new section to organize OneNote pages within a user's section group hierarchy. The section name must
- Create user notebook
Creates a new OneNote notebook for the signed-in user. Use this action when you need to create a new personal notebook to organize notes. The notebook will be created in the user's default OneDrive for Business location. Notebook names must
- Create user OneNote page
Creates a new OneNote page in the default section of the default notebook for a specific user. Use this action when you need to programmatically create a new page in a user's OneNote notebook. The page content must be provided as HTML. The
- Create user section page
Creates a new OneNote page in a specific section of a user's notebook. Use this action when you need to create a new page directly in a section within a user's OneNote notebook. The page content must be provided as valid HTML with proper st
- Delete OneNote page for userdestructive
Deletes a OneNote page from a user's OneNote workspace. This action is irreversible — the page and all its content will be permanently deleted once removed. Use this action when you need to remove an unwanted OneNote page from a user's note
- Delete OneNote page from sectiondestructive
Delete a specific OneNote page from a section within a notebook in a group. Use this action when you need to remove a OneNote page permanently from a group's notebook section. This action is irreversible - once deleted, the page cannot be r
- Delete OneNote page from sitedestructive
Deletes a OneNote page from a SharePoint site. Use this action when you need to remove a OneNote page permanently from a SharePoint site's OneNote workspace. This action is irreversible - once deleted, the page and all its content cannot be
- Delete page content from section group sectiondestructive
Deletes the HTML content of a OneNote page within a section in a section group in a Microsoft 365 group's OneNote workspace. This action is irreversible — the page content will be permanently deleted once removed. Use this action when you n
- Delete user OneNote page from sectiondestructive
Deletes a OneNote page from a section within a section group in a user's notebook. This action is irreversible — the page and all its content will be permanently deleted once removed. Use this action when you need to remove an unwanted page
- Get a OneNote page from a section group section
Retrieves a specific OneNote page from a section within a section group in a Microsoft 365 group's notebook. Use this action when you need to fetch metadata or details for a single OneNote page by navigating through its parent group, notebo
- Get a OneNote page from user
Retrieves a specific OneNote page from a user's OneNote notebooks. Use this action when you need to fetch metadata or details for a single OneNote page directly by page ID and user ID. This is useful for retrieving page information without
- Get a OneNote section from a group
Retrieves a specific OneNote section from a Microsoft 365 group. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the group ID and section ID. This action supports OData query parameters
- Get a OneNote section from a site
Retrieves a specific OneNote section from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the site ID and section ID. This action supports OData query parameters for s
- Get group OneNote operation status
Retrieves the status of a long-running OneNote operation for a group. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, CopyToSection) has completed, failed, or
- Get notebook from web URL
Retrieves a OneNote notebook by using its web URL path. Use this action when you have the SharePoint or OneDrive URL of a notebook and need to retrieve its properties and metadata. The webUrl parameter accepts both standard HTTPS URLs and O
- Get notebook section group
Retrieves a specific section group from a OneNote notebook within a Microsoft 365 group. Use this action when you need to get details about a specific section group, including its name, creation/modification timestamps, and links to its sec
- Get OneNote page content for user
Gets the HTML content of a specific OneNote page for a user. Use this action when you need to retrieve the actual HTML content of a specific OneNote page for reading, processing, or displaying page content. The action supports the includeID
- Get OneNote page content from section
Retrieves the HTML content of a specific OneNote page from a section for the signed-in user. Use this action when you need to fetch the full HTML content of a OneNote page within a specific section. This endpoint provides access to page con
- Get OneNote page from site
Retrieves a specific OneNote page from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote page by its page identifier within a SharePoint site. This action supports optional OData query parame
- Get OneNote page from site section group section
Retrieves a specific OneNote page from a section within a section group in a SharePoint site notebook. Use this action when you need to fetch metadata or details for a single OneNote page by navigating through its parent site, notebook, sec
- Get OneNote resource content by ID
Retrieves the binary content of a specific OneNote resource using its ID. Use this action when you need to fetch the raw binary content of an image, file attachment, or other embedded resource from a OneNote page in the signed-in user's not
- Get parent section group from user section
Retrieves the parent section group of a OneNote section within a user's notebook. Use this action when you need to navigate up the OneNote hierarchy from a section to its parent section group, for example to determine which section group co
- Get site notebook page preview
Retrieves a text preview of a specific OneNote page from a section within a section group in a SharePoint site-hosted notebook. Use this action when you need to quickly get the content preview of a OneNote page from a site-hosted notebook w
- Get site OneNote operation status
Retrieves the status of a long-running OneNote operation for a SharePoint site. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, CopyToSection) has completed, f
- Get user notebook
Retrieves the properties and relationships of a OneNote notebook by ID for a specific user. Use this action when you need to fetch details about a specific notebook belonging to a user, including its display name, sharing status, section UR
- List group OneNote pages
Lists all OneNote pages from a Microsoft 365 group. Use this action when you need to retrieve all OneNote pages within a Microsoft 365 group. Supports pagination via the page_size parameter. The default page size is 25, and the maximum is 1
- List group section group section groups
Lists all section groups from a specified parent section group within a Microsoft 365 group's OneNote notebook. Use this action when you need to retrieve the nested section groups within a section group in a group context to navigate the On
- List notebook section groups
Retrieves a list of section groups from the specified notebook within a Microsoft 365 group. Use this action when you need to list all section groups in a group-owned OneNote notebook to understand its structure or to find a specific sectio
- List pages from a group notebook section
Lists all OneNote pages from a specific section within a notebook in a Microsoft 365 group. Use this action when you need to retrieve all pages from a known section in a group notebook. This action accesses pages directly through the sectio
- List pages from a group section
Lists all OneNote pages from a specific section in a Microsoft 365 group. Use this action when you need to retrieve all pages from a known section in a group notebook without specifying the notebook ID. This action supports pagination, filt
- List pages in section
Retrieves a list of OneNote pages from a specific section for the current user. Use this action when you need to retrieve all pages from a specific section in the current user's OneNote notebook. This action supports pagination, filtering,
- List section group sections
Lists all OneNote sections from a specific section group within a Microsoft 365 group's OneNote. Use this action when you need to retrieve the sections contained within a section group in a group-owned OneNote notebook. Supports pagination
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Microsoft OneNote in the MCP directory and click Connect. 3. You'll be redirected to Microsoft's OAuth consent screen — sign in with your work or school account. 4. Grant the requested permissions: Notes.ReadWrite.All (to read and modify notebooks) and Sites.Read.All (to access SharePoint-hosted notebooks). 5. If your organization requires admin consent for tenant-wide scopes, contact your IT admin to approve the app before proceeding. 6. After approval, you'll return to Switchy and see a green Connected status next to OneNote. 7. Open any Space and type '@Microsoft OneNote list my notebooks' to confirm the connection works. 8. To invoke a tool, @mention the MCP and describe what you need — for example, '@Microsoft OneNote copy the Sprint Planning section from the Engineering notebook to the Archive notebook'.
What teammates see: by default, memories from Microsoft OneNote are scoped to the Space (PROJECT visibility) — you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List All Notebooks
@Microsoft OneNote show me all notebooks I can access, grouped by location (personal, group, or site).Open in a Space →
Copy Section to Archive
@Microsoft OneNote copy the 'Q4 Retrospective' section from the Product Team notebook into the Archive notebook under the 2024 section group.Open in a Space →
Move Page to New Section
@Microsoft OneNote copy the page titled 'API Design Decisions' from the Engineering notebook's Draft section into the Final Specs section.Open in a Space →
Duplicate Group Notebook
@Microsoft OneNote copy the Sales Playbook notebook from the Sales group into the Marketing group's document library.Open in a Space →
Consolidate Meeting Notes
@Microsoft OneNote find all pages tagged 'Action Items' in the Leadership notebook and copy them into a new section called 'Consolidated Actions'.Open in a Space →
Example outputs
Illustrative — representative of the model's voice and quality, not literal recordings.
@Microsoft OneNote list all sections in my 'Product Strategy' notebook and show me which ones were updated in the last 7 days
Found 8 sections in your 'Product Strategy' notebook. Recently updated sections include: 'Q1 Roadmap' (modified 2 days ago, 14 pages), 'Competitive Analysis' (modified 4 days ago, 9 pages), and 'Customer Feedback' (modified 6 days ago, 22 pages). The other 5 sections haven't been touched in over two weeks. The 'Customer Feedback' section has the most activity with 7 contributors this month.
This example demonstrates read-heavy operations across notebook structure. Requires Notes.Read scope at minimum. Response times vary with notebook size—large enterprise notebooks with hundreds of sections may take 3-5 seconds to enumerate. The MCP returns metadata only; page content requires separate calls.
@Microsoft OneNote copy the 'Sprint Retrospective' section from our team's shared notebook into my personal 'Archive' notebook for reference
Initiated copy of 'Sprint Retrospective' section (18 pages, 4.2 MB) to your 'Archive' notebook. OneNote is processing this asynchronously—the section should appear in your Archive within 30-90 seconds depending on content size. You'll receive a 202 Accepted response, meaning the copy started but isn't instant. The original section in the team notebook remains unchanged.
Showcases write operations with cross-context copying (shared to personal). Requires Notes.ReadWrite.All scope. The async nature means you can't immediately reference the copied content—there's a propagation delay. Large sections with embedded files or ink drawings take longer. This creates a duplicate; it doesn't move the original.
@Microsoft OneNote find all pages tagged 'action-item' across my work notebooks and create a summary page in my 'Weekly Review' section with links to each one
Searched 4 work notebooks and found 23 pages tagged 'action-item'. Created a new summary page 'Action Items Rollup - Jan 2025' in your 'Weekly Review' section. The page lists each action item with its source notebook, last modified date, and a direct link. Grouped by notebook: 'Project Alpha' (9 items), 'Client Notes' (7 items), 'Team Meetings' (5 items), 'Personal Tasks' (2 items). Note: This snapshot is current as of now—it won't auto-update as you complete items.
Demonstrates synthesis capability—the AI combines search results with page creation. Requires both read and write scopes (Notes.ReadWrite). Tag-based search can be slow across many notebooks (5-10 seconds for large accounts). The generated summary is static; OneNote doesn't support dynamic queries, so you'd need to re-run this prompt weekly to refresh the list.
Use-case deep-dives
When OneNote MCP wins for repeatable client kickoffs
A 6-person consulting shop runs the same discovery workshop for every new client. They keep a master OneNote notebook with interview templates, stakeholder maps, and a standard project timeline. Before each kickoff, an account manager copies the relevant sections into a fresh client notebook using the section-copy tools. This MCP is the right call if your team already lives in OneNote and runs 3+ similar engagements per month. The OAuth2 flow means each team member authenticates once, then the AI can copy sections on demand during standup or planning calls. If your templates live in Notion or Confluence instead, switching to OneNote just for this workflow doesn't pay off. But if you're already a OneNote shop, this MCP turns your library into a self-service template engine.
When this MCP handles project transitions at scale
A 40-person product org uses SharePoint sites for each squad. When a feature ships and ownership moves from build team to support team, the PM copies the design notebook from the build site to the support site's library using the site-context copy tools. This MCP shines if you have 5+ handoffs per quarter and your org already enforces SharePoint structure. The 50 tools cover group, site, and user contexts, so the AI can route the copy based on who's asking. The trade-off: if your handoff process is ad-hoc or your teams don't use consistent SharePoint hierarchies, the MCP can't guess the right destination. It works when your information architecture is already locked in. For teams that size, the time saved on manual copy-paste justifies the OAuth setup.
When OneNote MCP speeds up rep onboarding
A 12-person sales team maintains a master playbook notebook with objection-handling scripts, demo flows, and competitive battle cards. When a new rep joins, the sales ops lead copies the playbook sections into the rep's personal OneNote using the user-context copy tools. This MCP is the right fit if you onboard 2+ reps per quarter and your playbook updates weekly. The AI can handle the copy during onboarding calls, so the ops lead doesn't context-switch to the OneNote UI. The boundary: if your playbook is static or you onboard once a year, the OAuth overhead isn't worth it. And if your reps don't actually open OneNote daily, copied sections just sit unused. This works when OneNote is already your single source of truth for sales content.
Frequently asked
What can the OneNote MCP do in Switchy?
It lets your AI agents read, create, and copy OneNote pages, sections, and notebooks across personal accounts, Microsoft 365 groups, and SharePoint sites. The 50 tools cover everything from duplicating sections between notebooks to moving pages across site collections. Your agents can automate note organisation, pull content for summaries, or sync research across team notebooks without opening the OneNote app.
Do I need admin permissions to connect OneNote?
No. Standard OAuth2 consent is enough for personal notebooks. For Microsoft 365 group notebooks or SharePoint sites, you need read/write access to those specific groups or sites — the same permissions you'd need to edit them manually in OneNote. If your org restricts third-party OAuth apps, your IT admin will need to approve Switchy in the Azure portal first.
Can it edit existing OneNote pages or only copy them?
The MCP focuses on copying and moving content between notebooks, sections, and section groups. It doesn't expose inline text editing or formatting changes to existing pages. If your agent needs to update a page's content, it would typically create a new page with the revised text rather than patching the old one. For bulk edits, the Graph API directly is still faster.
Why use this instead of the OneNote API directly?
The MCP wraps Microsoft's Graph API with 50 pre-built tools, so your agents don't need custom code for every copy or move operation. It handles OAuth token refresh, pagination, and the async copy flows OneNote uses. If you're already writing Python scripts against Graph, stick with that. If you want agents to organise notes conversationally, the MCP is faster to set up.
Who on the team should connect the OneNote MCP?
Whoever owns the notebooks your agents need to touch. If you're automating personal research notes, connect your own account. For shared team notebooks in Microsoft 365 groups, connect an account that's a member of those groups. Each Switchy workspace can hold multiple OneNote connections, so different agents can work with different notebooks without sharing credentials.