View as Markdown
Microsoft OneNote icon

Microsoft OneNote ACTION

Search Pages

Search and list OneNote pages. Supports free-text title search, OData filtering, expansion of related resources, and pagination. Use search for natural-language queries against page titles (e.g., weekly notes, feeding schedule). Translated server-side to a case-insensitive contains filter on the page title. Use filter for structured OData queries (e.g., createdDateTime gt 2026-01-01T00:00:00Z). search and filter can be combined and are joined with and. Limitation: Microsoft Graph does not support searching OneNote page body content via this endpoint. To match on content, retrieve a candidate set by title and then call Get Page Content for each. Use Get Page Content to retrieve the body of a specific page after locating it here. Use Get Page for page metadata only. Returns the array of matching pages and a nextLink URL for pagination when more results are available. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Microsoft OneNote account once, then configure and run Search Pages from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "onenote-search-pages",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    onenote: { authProvisionId: "apn_xxxxxxx" },
    search: "Search",
    filter: "Filter",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Pages inputs
Property Type Description
search Search string
Free-text search against page titles. Case-insensitive substring match. Example: weekly notes, feeding schedule. Translated server-side to contains(tolower(title), '<value>').
Optional
filter Filter string
OData filter expression for structured queries. Example: createdDateTime gt 2026-01-01T00:00:00Z, title eq 'Weekly Notes'. Combined with search via and when both are set. See the documentation
Optional
expand Expand string
Expand the response
Optional
top Top integer
Number of pages to return (max 100). Defaults to the Graph API's standard page size when omitted.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
onenote-search-pages
Version
1.0.1
App
Microsoft OneNote
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes