> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# microsoft-365-onenote

> Microsoft 365 OneNote — manage notebooks, sections, and pages; read and write page content

**Server path:** `/microsoft-365-onenote` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                              | Description                                                                                                                                                  |
| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`microsoft-365-onenote_create_notebook_section`](#microsoft-365-onenote_create_notebook_section) | Create a section in a OneNote notebook                                                                                                                       |
| [`microsoft-365-onenote_create_onenote_notebook`](#microsoft-365-onenote_create_onenote_notebook) | Create a OneNote notebook                                                                                                                                    |
| [`microsoft-365-onenote_create_section_page`](#microsoft-365-onenote_create_section_page)         | Create a page in a OneNote section                                                                                                                           |
| [`microsoft-365-onenote_delete_page`](#microsoft-365-onenote_delete_page)                         | Delete a OneNote page                                                                                                                                        |
| [`microsoft-365-onenote_get_notebook`](#microsoft-365-onenote_get_notebook)                       | Get a single OneNote notebook by its ID.                                                                                                                     |
| [`microsoft-365-onenote_get_page`](#microsoft-365-onenote_get_page)                               | Get OneNote page metadata                                                                                                                                    |
| [`microsoft-365-onenote_get_page_content`](#microsoft-365-onenote_get_page_content)               | Get OneNote page HTML content                                                                                                                                |
| [`microsoft-365-onenote_list_notebook_sections`](#microsoft-365-onenote_list_notebook_sections)   | List sections in a OneNote notebook                                                                                                                          |
| [`microsoft-365-onenote_list_onenote_notebooks`](#microsoft-365-onenote_list_onenote_notebooks)   | List OneNote notebooks                                                                                                                                       |
| [`microsoft-365-onenote_list_section_pages`](#microsoft-365-onenote_list_section_pages)           | List pages in a OneNote section                                                                                                                              |
| [`microsoft-365-onenote_search_pages`](#microsoft-365-onenote_search_pages)                       | Search OneNote pages by title and content text.                                                                                                              |
| [`microsoft-365-onenote_update_page`](#microsoft-365-onenote_update_page)                         | Update the content of a OneNote page by appending, prepending, replacing, or inserting HTML relative to a target element (default: append to the page body). |

***

## microsoft-365-onenote\_create\_notebook\_section

Create a section in a OneNote notebook

**Parameters:**

| Parameter     | Type   | Required | Default | Description                           |
| ------------- | ------ | -------- | ------- | ------------------------------------- |
| `notebook_id` | string | Yes      | —       | The unique ID of the OneNote notebook |
| `displayName` | string | Yes      | —       | Display name for the new section      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "notebook_id": {
        "type": "string",
        "description": "The unique ID of the OneNote notebook"
      },
      "displayName": {
        "type": "string",
        "description": "Display name for the new section"
      }
    },
    "required": [
      "PCID",
      "notebook_id",
      "displayName"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_create\_onenote\_notebook

Create a OneNote notebook

**Parameters:**

| Parameter     | Type   | Required | Default | Description                       |
| ------------- | ------ | -------- | ------- | --------------------------------- |
| `displayName` | string | Yes      | —       | Display name for the new notebook |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "displayName": {
        "type": "string",
        "description": "Display name for the new notebook"
      }
    },
    "required": [
      "PCID",
      "displayName"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_create\_section\_page

Create a page in a OneNote section

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                                     |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------------------------------- |
| `section_id` | string | Yes      | —       | The unique ID of the OneNote section                                            |
| `body`       | string | Yes      | —       | HTML content of the OneNote page. Must include a title tag in the head element. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "section_id": {
        "type": "string",
        "description": "The unique ID of the OneNote section"
      },
      "body": {
        "type": "string",
        "description": "HTML content of the OneNote page. Must include a title tag in the head element."
      }
    },
    "required": [
      "PCID",
      "section_id",
      "body"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_delete\_page

Delete a OneNote page

**Parameters:**

| Parameter | Type   | Required | Default | Description                                 |
| --------- | ------ | -------- | ------- | ------------------------------------------- |
| `page_id` | string | Yes      | —       | The unique ID of the OneNote page to delete |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page_id": {
        "type": "string",
        "description": "The unique ID of the OneNote page to delete"
      }
    },
    "required": [
      "PCID",
      "page_id"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_get\_notebook

Get a single OneNote notebook by its ID.

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                                       |
| ------------- | ------ | -------- | ------- | --------------------------------------------------------------------------------- |
| `notebook_id` | string | Yes      | —       | The unique ID of the OneNote notebook                                             |
| `$select`     | string | No       | —       | Comma-separated properties to return (e.g. "id,displayName,lastModifiedDateTime") |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "notebook_id": {
        "type": "string",
        "description": "The unique ID of the OneNote notebook"
      },
      "$select": {
        "type": "string",
        "description": "Comma-separated properties to return (e.g. \"id,displayName,lastModifiedDateTime\")"
      }
    },
    "required": [
      "PCID",
      "notebook_id"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_get\_page

Get OneNote page metadata

**Parameters:**

| Parameter | Type   | Required | Default | Description                          |
| --------- | ------ | -------- | ------- | ------------------------------------ |
| `page_id` | string | Yes      | —       | The unique ID of the OneNote page    |
| `$select` | string | No       | —       | Comma-separated properties to return |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page_id": {
        "type": "string",
        "description": "The unique ID of the OneNote page"
      },
      "$select": {
        "type": "string",
        "description": "Comma-separated properties to return"
      }
    },
    "required": [
      "PCID",
      "page_id"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_get\_page\_content

Get OneNote page HTML content

**Parameters:**

| Parameter | Type   | Required | Default | Description                       |
| --------- | ------ | -------- | ------- | --------------------------------- |
| `page_id` | string | Yes      | —       | The unique ID of the OneNote page |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page_id": {
        "type": "string",
        "description": "The unique ID of the OneNote page"
      }
    },
    "required": [
      "PCID",
      "page_id"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_list\_notebook\_sections

List sections in a OneNote notebook

**Parameters:**

| Parameter     | Type   | Required | Default | Description                           |
| ------------- | ------ | -------- | ------- | ------------------------------------- |
| `notebook_id` | string | Yes      | —       | The unique ID of the OneNote notebook |
| `$select`     | string | No       | —       | Comma-separated properties to return  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "notebook_id": {
        "type": "string",
        "description": "The unique ID of the OneNote notebook"
      },
      "$select": {
        "type": "string",
        "description": "Comma-separated properties to return"
      }
    },
    "required": [
      "PCID",
      "notebook_id"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_list\_onenote\_notebooks

List OneNote notebooks

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                                       |
| ---------- | ------- | -------- | ------- | --------------------------------------------------------------------------------- |
| `$orderby` | string  | No       | —       | Sort order (e.g. "displayName asc", "lastModifiedDateTime desc")                  |
| `$select`  | string  | No       | —       | Comma-separated properties to return (e.g. "id,displayName,lastModifiedDateTime") |
| `$top`     | integer | No       | —       | Number of notebooks to return                                                     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "$orderby": {
        "type": "string",
        "description": "Sort order (e.g. \"displayName asc\", \"lastModifiedDateTime desc\")"
      },
      "$select": {
        "type": "string",
        "description": "Comma-separated properties to return (e.g. \"id,displayName,lastModifiedDateTime\")"
      },
      "$top": {
        "type": "integer",
        "description": "Number of notebooks to return"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_list\_section\_pages

List pages in a OneNote section

**Parameters:**

| Parameter    | Type    | Required | Default | Description                                                                 |
| ------------ | ------- | -------- | ------- | --------------------------------------------------------------------------- |
| `section_id` | string  | Yes      | —       | The unique ID of the OneNote section                                        |
| `$orderby`   | string  | No       | —       | Sort order (e.g. "lastModifiedDateTime desc")                               |
| `$select`    | string  | No       | —       | Comma-separated properties to return (e.g. "id,title,lastModifiedDateTime") |
| `$top`       | integer | No       | —       | Number of pages to return                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "section_id": {
        "type": "string",
        "description": "The unique ID of the OneNote section"
      },
      "$orderby": {
        "type": "string",
        "description": "Sort order (e.g. \"lastModifiedDateTime desc\")"
      },
      "$select": {
        "type": "string",
        "description": "Comma-separated properties to return (e.g. \"id,title,lastModifiedDateTime\")"
      },
      "$top": {
        "type": "integer",
        "description": "Number of pages to return"
      }
    },
    "required": [
      "PCID",
      "section_id"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_search\_pages

Search OneNote pages by title and content text.

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                               |
| ------------- | ------- | -------- | ------- | --------------------------------------------------------- |
| `search_text` | string  | Yes      | —       | Text to search for across OneNote page titles and content |
| `$top`        | integer | No       | —       | Maximum number of pages to return                         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "search_text": {
        "type": "string",
        "description": "Text to search for across OneNote page titles and content"
      },
      "$top": {
        "type": "integer",
        "description": "Maximum number of pages to return"
      }
    },
    "required": [
      "PCID",
      "search_text"
    ]
  }
  ```
</Expandable>

***

## microsoft-365-onenote\_update\_page

Update the content of a OneNote page by appending, prepending, replacing, or inserting HTML relative to a target element (default: append to the page body).

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                      |
| --------- | ------ | -------- | ------- | -------------------------------------------------------------------------------- |
| `page_id` | string | Yes      | —       | The unique ID of the OneNote page to update                                      |
| `content` | string | Yes      | —       | The HTML content to apply (e.g. "\<p>New paragraph\</p>")                        |
| `action`  | string | No       | —       | How to apply the content: "append" (default), "prepend", "insert", or "replace". |
| `target`  | string | No       | —       | The element to target: "body" (default) or a data-id of an element on the page.  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page_id": {
        "type": "string",
        "description": "The unique ID of the OneNote page to update"
      },
      "content": {
        "type": "string",
        "description": "The HTML content to apply (e.g. \"<p>New paragraph</p>\")"
      },
      "action": {
        "type": "string",
        "description": "How to apply the content: \"append\" (default), \"prepend\", \"insert\", or \"replace\"."
      },
      "target": {
        "type": "string",
        "description": "The element to target: \"body\" (default) or a data-id of an element on the page."
      }
    },
    "required": [
      "PCID",
      "page_id",
      "content"
    ]
  }
  ```
</Expandable>
