{
 "categories": [
  "productivity",
  "notes",
  "office-suite"
 ],
 "deployment": "hybrid",
 "evidence": [
  {
   "date": "2026-08-16",
   "fact": "homepage",
   "note": "Microsoft presents OneNote as its current synchronized digital notebook for typed, handwritten, audio, image, and collaborative notes.",
   "source": "https://www.microsoft.com/en-us/microsoft-365/onenote/digital-note-taking-app",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "platforms",
   "note": "Microsoft distributes OneNote for PC, Mac, iPhone, iPad, Android phones and tablets, and through the web.",
   "source": "https://www.microsoft.com/en-us/microsoft-365/onenote/digital-note-taking-app",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "license",
   "note": "OneNote has a free application and account path while Microsoft 365 subscriptions add storage, Copilot, and paid-plan capabilities.",
   "source": "https://www.microsoft.com/en-us/microsoft-365/onenote/digital-note-taking-app",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.api.exists",
   "note": "Microsoft Graph provides a stable OneNote API for authorized notebooks, sections, section groups, pages, and resources.",
   "source": "https://learn.microsoft.com/en-us/graph/api/resources/onenote-api-overview?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.api.kinds[0]",
   "note": "OneNote operations use Microsoft Graph REST endpoints under graph.microsoft.com v1.0.",
   "source": "https://learn.microsoft.com/en-us/graph/api/resources/onenote-api-overview?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.api.auth[0]",
   "note": "The stable OneNote overview requires appropriate delegated Notes permissions and explicitly says the API does not support app-only authentication.",
   "source": "https://learn.microsoft.com/en-us/graph/api/resources/onenote-api-overview?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.api.coverage",
   "note": "Graph lists and creates OneNote hierarchy resources and performs page read, create, HTML update, copy, and delete operations, but it does not expose the complete native canvas or search experience.",
   "source": "https://learn.microsoft.com/en-us/graph/api/resources/onenote?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.sdk",
   "note": "Microsoft publishes generated Graph SDKs with typed models, request builders, authentication, paging, batching, retries, redirects, and compression.",
   "source": "https://learn.microsoft.com/en-us/graph/sdks/sdks-overview",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.sdk.languages",
   "note": "Current Graph SDKs are available for C#, Go, Java, TypeScript and JavaScript, PHP, PowerShell, and Python.",
   "source": "https://learn.microsoft.com/en-us/graph/sdks/sdks-overview",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.integrations.power_automate",
   "note": "Microsoft publishes the standard OneNote Business connector for Power Automate, Logic Apps, Power Apps, and Copilot Studio.",
   "source": "https://learn.microsoft.com/en-us/connectors/onenote/",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.cli.exists",
   "note": "Microsoft's generated OneNote examples include the Microsoft.Graph.Notes PowerShell module and typed OneNote cmdlets.",
   "source": "https://learn.microsoft.com/en-us/graph/api/page-delete?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.extensibility.scripting",
   "note": "OneNote can be scripted through Microsoft Graph REST, generated clients and PowerShell, and Microsoft's workflow connector.",
   "source": "https://learn.microsoft.com/en-us/graph/sdks/sdks-overview",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.data_access.export",
   "note": "Graph returns notebook hierarchy and page metadata as JSON and page content as HTML with optional generated element identifiers.",
   "source": "https://learn.microsoft.com/en-us/graph/api/page-get?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "modalities.data_access.import",
   "note": "Graph creates pages from HTML or multipart HTML and binary content, and uses JSON change objects with HTML fragments to update page elements.",
   "source": "https://learn.microsoft.com/en-us/graph/onenote-create-page",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "verdict.scores.api",
   "note": "The stable API supports meaningful hierarchy and page CRUD, but delegated-auth dependence, conflicting app-permission documentation, HTML patch semantics, unsupported elements, size limits, and incomplete cloud coverage constrain autonomy.",
   "source": "https://learn.microsoft.com/en-us/graph/onenote-update-page",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "verdict.scores.integrations",
   "note": "The first-party standard connector covers page and section CRUD with useful creation triggers across four Microsoft workflow products, but requires OneDrive for Business and has a 100-calls-per-minute connection limit and 20-minute trigger polling.",
   "source": "https://learn.microsoft.com/en-us/connectors/onenote/",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "verdict.scores.cli",
   "note": "Generated Graph PowerShell cmdlets provide structured OneNote page and hierarchy automation, but they inherit the API's permission, content-model, region, and throttling limits.",
   "source": "https://learn.microsoft.com/en-us/graph/api/page-delete?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "freshness.watch[0].url",
   "note": "Opened and verified as the current stable OneNote API location and authentication boundary.",
   "source": "https://learn.microsoft.com/en-us/graph/api/resources/onenote-api-overview?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "freshness.watch[1].url",
   "note": "Opened and verified as the current stable OneNote resource and method index.",
   "source": "https://learn.microsoft.com/en-us/graph/api/resources/onenote?view=graph-rest-1.0",
   "tier": "declared"
  },
  {
   "date": "2026-08-16",
   "fact": "freshness.watch[2].url",
   "note": "Opened and verified as the current Microsoft-published OneNote Business connector reference.",
   "source": "https://learn.microsoft.com/en-us/connectors/onenote/",
   "tier": "declared"
  }
 ],
 "freshness": {
  "last_verified": "2026-08-16",
  "volatility": "high",
  "watch": [
   {
    "type": "docs",
    "url": "https://learn.microsoft.com/en-us/graph/api/resources/onenote-api-overview?view=graph-rest-1.0"
   },
   {
    "type": "docs",
    "url": "https://learn.microsoft.com/en-us/graph/api/resources/onenote?view=graph-rest-1.0"
   },
   {
    "type": "docs",
    "url": "https://learn.microsoft.com/en-us/connectors/onenote/"
   }
  ]
 },
 "homepage": "https://www.microsoft.com/en-us/microsoft-365/onenote/digital-note-taking-app",
 "id": "onenote",
 "license": "freemium",
 "modalities": {
  "agent_docs": {
   "llms_txt": "unknown"
  },
  "api": {
   "auth": [
    "oauth2-delegated"
   ],
   "coverage": "partial",
   "docs": "https://learn.microsoft.com/en-us/graph/api/resources/onenote-api-overview?view=graph-rest-1.0",
   "exists": true,
   "kinds": [
    "rest"
   ]
  },
  "cli": {
   "exists": true
  },
  "computer_use": {
   "issues": [],
   "viability": "unknown"
  },
  "data_access": {
   "export": [
    "graph-json",
    "page-html"
   ],
   "import": [
    "graph-json",
    "page-html"
   ]
  },
  "extensibility": {
   "scripting": [
    "microsoft-graph",
    "graph-powershell",
    "power-automate"
   ],
   "webhooks": "unknown"
  },
  "integrations": {
   "make": "unknown",
   "n8n": "unknown",
   "power_automate": true,
   "zapier": "unknown"
  },
  "mcp": {
   "first_party": "unknown",
   "third_party": [],
   "verdict": "unknown"
  },
  "rpa": {
   "drivability": "unknown",
   "notes": "No repeatable UI probe was run. Microsoft Graph, generated Graph clients, PowerShell, and the first-party Power Automate connector provide supported notebook automation without controlling the OneNote canvas.",
   "ui_stack": [
    "web-dom",
    "windows-native",
    "macos-native"
   ],
   "vendor_support": []
  },
  "sdk": {
   "exists": true,
   "languages": [
    "csharp",
    "go",
    "java",
    "javascript",
    "php",
    "powershell",
    "python"
   ],
   "official": true
  }
 },
 "name": "OneNote",
 "platforms": [
  "web",
  "windows",
  "macos",
  "ios",
  "android"
 ],
 "related": {
  "alternatives": [
   "obsidian",
   "notion",
   "evernote"
  ],
  "our_products": []
 },
 "schema_version": 1,
 "score_version": 1,
 "status": "active",
 "vendor": "Microsoft",
 "verdict": {
  "best_path": "api",
  "scores": {
   "api": 7,
   "cli": 7,
   "computer_use": null,
   "integrations": 7,
   "mcp": null,
   "overall": 7,
   "rpa": null
  },
  "summary": "OneNote has a real but content-model-constrained automation surface rather than no API. Microsoft Graph v1.0 can list and create notebooks, sections, section groups, and pages for personal OneDrive, Microsoft 365, group, and SharePoint-site notebooks. It retrieves page bodies as HTML and creates or modifies pages through HTML, multipart payloads, and element-targeted JSON patches; it can also copy and permanently delete pages. The stable overview explicitly says that the OneNote API does not support app-only authentication, so unattended tenant automation must not be assumed even though some operation pages now display application-permission rows. That documentation conflict needs a live tenant probe before any app-only design is accepted. The API also has HTML-element restrictions, request and section limits, incomplete national-cloud availability, and no full-fidelity canvas object model or general search surface. Microsoft's generated Graph SDKs and Graph PowerShell module expose the same API as typed clients and cmdlets. The standard first-party OneNote Business connector gives Power Automate, Logic Apps, Power Apps, and Copilot Studio practical page and section actions plus polling triggers, but it requires a OneDrive for Business notebook and has documented throttling and feature limits. An official OneNote-specific MCP server, native change-notification surface, and repeatable computer-use result were not established.\n"
 }
}