onenote-reference-architecture

Featured

Reference architecture for OneNote integrations covering all notebook locations and API path patterns. Use when designing multi-tenant OneNote integrations or choosing between personal, SharePoint, and group notebook APIs. Trigger with "onenote architecture", "onenote api paths", "onenote sharepoint vs personal".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# OneNote Reference Architecture ## Overview OneNote notebooks live in three completely different storage backends — personal OneDrive, SharePoint team sites, and Microsoft 365 Groups — each with its own Graph API path, permission model, and behavioral quirks. Building an integration that "just works with OneNote" means handling all three locations, because users do not know (or care) where their notebook is stored. The API path `/me/onenote/notebooks` only returns personal notebooks; SharePoint and Group notebooks require different endpoints entirely. This skill maps the full architecture: storage locations, API paths, the object hierarchy (and its gotchas), and a service abstraction layer that normalizes all three locations into a single interface. ## Prerequisites - Azure AD app registration with delegated permissions (`Notes.ReadWrite` minimum) - Familiarity with Microsoft Graph API URL structure (`https://graph.microsoft.com/v1.0`) - For SharePoint notebooks: `Sites.Read.All` or `Sites.ReadWrite.All` permission - For Group notebooks: `Group.Read.All` or `Group.ReadWrite.All` permission - Python: `pip install msgraph-sdk azure-identity` or Node: `npm install @microsoft/microsoft-graph-client @azure/identity` ## Instructions ### System Architecture ``` ┌─────────────┐ ┌──────────────┐ ┌─────────────────┐ │ Your App │────>│ MSAL Auth │────>│ Azure AD │ │ (Client) │ │ (Delegated) │ │ Token Service │ └──────┬──────┘ └─────────────...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category