Description

n8n-nodes-onenote

This package provides nodes for n8n that enable full integration with Microsoft OneNote through the Microsoft Graph API.
It allows automation, integration, and orchestration of note-related operations directly within n8n workflows.

About the Author

This community node was created and shared by Liam Chen for the n8n community.
It was designed to simplify the complexity of using Microsoft Graph OneNote APIs by providing a clean and easy-to-use interface.

Table of Contents

• Features
• Available Resources
• Authentication Methods
• Setting up the Application in Microsoft Entra ID (Azure AD)
• Using the Node
• Limitations and Troubleshooting
• Additional Resources
• License

Features

This package provides a simple OneNote node with flexible authentication and OneNote functionality.

OneNote Node

Comprehensive node supporting two authentication methods:

1. OAuth2 Authentication – Secure connection through Microsoft Entra ID (formerly Azure AD).
2. Bearer Token Authentication – Direct token-based integration for advanced users.

Available Features

• Notebook, Section, and Page listing
• Page creation with plain text or HTML
• Retrieve page metadata and content
• Dynamic dropdowns for Notebook → Section → Page (list search with pagination)
• Optional support for multiple scopes (e.g., /me, /users/{id}, /sites/{id})

Available Resources

Notebook Resources

• List Notebooks – Retrieves all available notebooks for the authenticated user
• Get Notebook Details – Retrieves information about a specific notebook

Section Resources

• List Sections – Retrieves all sections within a notebook
• Get Section Details – Retrieves metadata for a specific section

Page Resources

• List Pages – Lists all pages within a section
• Get Page – Retrieves a specific page by ID
• Create Page – Creates a new page under the selected section
• Get Page Content – Retrieves the full HTML content of a page

Authentication Methods

The OneNote node supports two authentication types:

1. OAuth2 Authentication

Use case:
Recommended for most scenarios — enables secure, refreshable access via Microsoft Entra ID.

Credential type:
OneNote OAuth2 API

Token management:
Automatically refreshed when tokens expire.

2. Bearer Token Authentication

Use case:
For advanced integrations or quick API testing.

Credential type:
OneNote API

Token management:
Manual — you must refresh the token periodically.

Selecting Authentication Method

1. In the node configuration, choose Authentication (OAuth2 or Bearer Token).
2. The appropriate credential type will automatically appear.
3. Fill in the corresponding credential fields.

Setting up the Application in Microsoft Entra ID (Azure AD)

To use OAuth2 authentication, you must register your application in Microsoft Entra ID (Azure AD).

1. Register a New Application

1. Go to the Azure Portal.
2. Navigate to Microsoft Entra ID → App registrations → New registration.
3. Enter a name, e.g., n8n OneNote Integration.
4. Under Supported account types, choose your desired access scope (e.g., single organization).
5. Under Redirect URI, select Web and enter:
   • For cloud-hosted n8n:
     https://your-n8n-domain/rest/oauth2-credential/callback
   • For local development:
     http://localhost:5678/rest/oauth2-credential/callback
6. Click Register.

2. Configure API Permissions

1. In your app’s menu, select API Permissions → Add a permission → Microsoft Graph.
2. Select Delegated permissions, then add:
   • Notes.Read or Notes.ReadWrite (required)
   • offline_access, openid, profile (recommended for OAuth2)
   • If you plan to access other users’ notebooks: Sites.Read.All, Users.Read.All
3. Click Add permissions, and request Admin consent if necessary.

3. Create a Client Secret

1. Go to Certificates & secrets → New client secret.
2. Add a description and choose an expiration period.
3. Click Add, and copy the secret value immediately (you cannot see it again).

4. Gather Required Values

You’ll need the following for n8n configuration:

• Client ID – Found under Overview → Application (client) ID
• Client Secret – The value you just copied
• Tenant ID – Found under Overview → Directory (tenant) ID

For Bearer Token Authentication:

• Credential type: OneNote API
• Access Token: Paste your Microsoft Graph access token manually.
• Select Resource (Notebook, Section, Page) and Operation.
• Configure operation-specific parameters (Notebook ID, Section ID, etc.).
• Execute the node and verify the output.

Limitations and Troubleshooting

Microsoft Graph OneNote API Limitations

• Rate limits: Standard Graph API rate limits apply. Reduce frequency or use pagination for large queries.
• Permissions: Ensure your app has Notes.ReadWrite and admin consent if required.
• HTML format requirements: For Create Page, your content must include valid HTML (<html><head>...</head><body>...</body></html>).
• Access scope: To access shared notebooks or other users’ data, proper delegated permissions and consent are required.
• Bearer Token expiry: Tokens expire unless obtained via OAuth2 refresh flow.

Additional Resources

• Microsoft Graph – OneNote API Overview
• Microsoft Graph Explorer
• Microsoft Graph Permissions Reference
• n8n Custom Node Development Guide

License

MIT