Microsoft OneNote MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Microsoft OneNote MCP or direct API to create notes, search notebooks, update pages, and organize sections through natural language.

Microsoft OneNote logoMicrosoft OneNote
Oauth2

Microsoft OneNote is a digital notebook for capturing notes, drawings, research, and web clippings. It keeps notebooks, sections, and pages organized across devices so ideas stay easy to find.

71 Tools

Try Microsoft OneNote now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Microsoft OneNote
Try asking
TOOLS

Supported Tools

Every Microsoft OneNote action and event your agent gets out of the box.

Copy notebook in group

Copies a OneNote notebook to the Notebooks folder in the destination Documents library.

Copy notebook in site

Copies a OneNote notebook to the destination site in the SharePoint documents library.

Copy section to notebook (site context)

Copies a OneNote section to a specific notebook within a SharePoint site.

Copy section to notebook (user)

Copies a OneNote section to a specific notebook for a specified user.

Copy group section to section group

Copies a OneNote section from a Microsoft 365 group's notebook into another section group.

Copy section to section group (user)

Copies a OneNote section to a specific section group for a specified user.

Copy site page to section

Copies a OneNote page from a SharePoint site to a destination section.

Copy user page to section

Copy a OneNote page from a user's notebook to a specified section.

Count notebook section group sections

Gets the count of OneNote sections within a section group in a user's notebook.

Count site notebook section group sections

Gets the count of sections within a OneNote section group in a SharePoint site notebook.

Create group notebook

Creates a new OneNote notebook within a Microsoft 365 group.

Create group OneNote page

Creates a new OneNote page in the default section of the default notebook for a Microsoft 365 group.

Create section in section group

Creates a new OneNote section within a specified section group of a Microsoft 365 group.

Create user notebook

Creates a new OneNote notebook for the signed-in user.

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.

Create OneNote page in section

Creates a new OneNote page in a specific section for the signed-in user.

Create section group in group notebook

Creates a new section group within a OneNote notebook that belongs to a Microsoft 365 group.

Create section in site notebook

Creates a new OneNote section within a specified notebook in a SharePoint site.

Create section in user notebook

Creates a new OneNote section within a specified notebook for a specific user.

Create user OneNote page

Creates a new OneNote page in the default section of the default notebook for a specific user.

Create section in user section group

Creates a new OneNote section within a specified section group for a specific user.

Create user section page

Creates a new OneNote page in a specific section of a user's notebook.

Delete page content from section group section

Deletes the HTML content of a OneNote page within a section in a section group in a Microsoft 365 group's OneNote workspace.

Delete OneNote page from section

Delete a specific OneNote page from a section within a notebook in a group.

Delete OneNote page from site

Deletes a OneNote page from a SharePoint site.

Delete user OneNote page from section

Deletes a OneNote page from a section within a section group in a user's notebook.

Delete OneNote page for user

Deletes a OneNote page from a user's OneNote workspace.

Get a OneNote section from a group

Retrieves a specific OneNote section from a Microsoft 365 group.

Get OneNote resource content by ID

Retrieves the binary content of a specific OneNote resource using its ID.

Get OneNote page content from section

Retrieves the HTML content of a specific OneNote page from a section for the signed-in user.

Get notebook from web URL

Retrieves a OneNote notebook by using its web URL path.

Get notebook section group

Retrieves a specific section group from a OneNote notebook within a Microsoft 365 group.

Get group OneNote operation status

Retrieves the status of a long-running OneNote operation for a group.

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.

Get site OneNote operation status

Retrieves the status of a long-running OneNote operation for a SharePoint site.

Get OneNote page content for user

Gets the HTML content of a specific OneNote page for a user.

Get a OneNote page

Retrieves metadata and properties of a specific OneNote page from the authenticated user's notebooks.

Get recent notebooks

Retrieves a list of recently accessed OneNote notebooks for the signed-in user.

Get a OneNote section by ID

Retrieves a specific OneNote section by its ID from the current user's OneNote.

Get OneNote page from site

Retrieves a specific OneNote page from a SharePoint site.

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.

Get a OneNote section from a site

Retrieves a specific OneNote section from a SharePoint site.

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.

Get user notebook

Retrieves the properties and relationships of a OneNote notebook by ID for a specific user.

Get a OneNote page from user

Retrieves a specific OneNote page from a user's OneNote notebooks.

Get parent section group from user section

Retrieves the parent section group of a OneNote section within a user's notebook.

List group notebooks

List OneNote notebooks owned by a Microsoft 365 group or Teams team.

List notebook section groups

Retrieves a list of section groups from the specified notebook within a Microsoft 365 group.

List pages from a group notebook section

Lists all OneNote pages from a specific section within a notebook in a Microsoft 365 group.

List section group sections

Lists all OneNote sections from a specific section group within a Microsoft 365 group's OneNote.

List joined teams

List Microsoft Teams that a user is a direct member of.

List pages in section

Retrieves a list of OneNote pages from a specific section for the current user.

List group OneNote pages

Lists all OneNote pages from a Microsoft 365 group.

List group section group section groups

Lists all section groups from a specified parent section group within a Microsoft 365 group's OneNote notebook.

List pages from a group section

Lists all OneNote pages from a specific section in a Microsoft 365 group.

List site notebooks

List OneNote notebooks stored in a SharePoint site.

List site notebook section groups

Retrieves a list of section groups from the specified notebook within a SharePoint site.

Get OneNote page content from SharePoint site

Retrieves the HTML content of a specific OneNote page within a SharePoint site.

List site sections

Retrieves a list of OneNote sections from a SharePoint site.

List user notebooks

Lists all OneNote notebooks accessible by a specific user.

List user notebook sections

Lists all OneNote sections from a specified notebook belonging to a user.

Resolve SharePoint site by URL

Resolve a SharePoint site URL or hostname and path to a Microsoft Graph site resource.

Search SharePoint sites

Search SharePoint sites available through Microsoft Graph.

Update my OneNote page content

Update the content of a OneNote page for the signed-in user.

Update my OneNote section

Updates the navigation property sections in me.

Update OneNote page content

Update the content of a OneNote page within a Microsoft 365 group using HTML patch commands.

Update section in site notebook

Updates a OneNote section within a notebook in a SharePoint site.

Update site OneNote page content

Update the content of a OneNote page within a SharePoint site.

Update site section group section

Updates a OneNote section within a section group in a SharePoint site notebook.

Update section in user notebook

Updates a OneNote section within a user's notebook.

Validate OneNote credentials

Validates OneNote API credentials by attempting to access the user's notebooks.

SETUP GUIDE

Connect Microsoft OneNote MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Microsoft OneNote
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Find OneNote pages mentioning quarterly planning and summarize the key decisions.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Microsoft OneNote API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Microsoft OneNote Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a new OneNote page in my Work notebook titled Standup Notes with today\'s action items.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Microsoft OneNote actions with your Agent

Why Use Composio?

AI Native Microsoft OneNote Integration

  • Supports both Microsoft OneNote MCP and direct API based integrations, so your agent can work the way your stack already works
  • Structured, LLM-friendly schemas for reliable tool execution across notebooks, sections, and pages
  • Rich coverage for reading, writing, and querying your Microsoft OneNote workspace without bespoke integration code

Managed Auth

  • Bring your Microsoft OAuth credentials, then let Composio handle token storage, refresh, and lifecycle management
  • Central place to manage, scope, and revoke Microsoft OneNote access for users and agents
  • Per user and per environment credentials instead of hard-coded secrets sitting in your app

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what OneNote action ran, when, and on whose behalf
  • Built for natural language workflows like finding project notes, creating meeting summaries, and updating research pages

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Microsoft OneNote
  • Scoped, least privilege access to Microsoft OneNote notebooks, sections, and pages
  • Full audit trail of agent actions to support review, debugging, and compliance
FRAMEWORKS

Use Microsoft OneNote with any AI Agent Framework

Choose a Framework you want to connect Microsoft OneNote with

FAQ

Frequently asked questions

Yes, Microsoft OneNote requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Microsoft OneNote.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Microsoft OneNote tool your agent needs.Free to start.

Start building