Search

Notion

Search pages and data sources in a connected Notion workspace by title.

Use this tool with your AI agent

Copy the prompt
Paste it into your agent
Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Search (tool ID: notion.search). Ask me for the details you need, then show me the result. Help me connect the required app account if needed.

Already connected: Your agent can use that connection.
New user: Your agent will guide you through setup, sign-in and authorisation.

This tool also needs you to connect your app account.

Connect your first agent to receive $1 trial credit.

Job: Read and write Notion pages
Current price: $0.0025/request
Availability: Requires connected account

Tool details

About this tool

Searches titles across everything shared with the connection, optionally filtered to pages or data sources. Needs no ids, so it is the first call against a new Notion connection. Billed per upstream request at $0.0025; one page (up to 100 results) is one request.

Inputs and outputs

Input

bodyobject · optional

Notion search body. `query` matches titles; omit it to list everything shared. `filter` narrows to one object type.

max_pagesinteger · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 10

Output

pagesnumber

Returned pages value.

resultsarray

Returned results value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "notion.search",
  "input": {
    "body": {
      "query": "Planning",
      "filter": {
        "value": "page",
        "property": "object"
      },
      "page_size": 10
    },
    "max_pages": 1
  }
}

Output

{
  "pages": 1,
  "results": [
    {
      "id": "1b2c3d4e-0000-4000-8000-000000000001",
      "url": "https://app.notion.com/p/Project-roadmap-1b2c3d4e000040008000000000000001",
      "icon": {
        "type": "emoji",
        "emoji": "🗺️"
      },
      "cover": null,
      "object": "page",
      "parent": {
        "type": "page_id",
        "page_id": "1b2c3d4e-0000-4000-8000-000000000002"
      },
      "in_trash": false,
      "is_locked": false,
      "properties": {
        "title": {
          "id": "title",
          "type": "title",
          "title": [
            {
              "href": null,
              "text": {
                "link": null,
                "content": "Project roadmap"
              },
              "type": "text",
              "plain_text": "Project roadmap",
              "annotations": {
                "bold": false,
                "code": false,
                "color": "default",
                "italic": false,
                "underline": false,
                "strikethrough": false
              }
            }
          ]
        }
      },
      "public_url": null,
      "is_archived": false,
      "created_time": "2026-08-01T09:00:00.000Z",
      "last_edited_time": "2026-08-14T15:30:00.000Z"
    }
  ]
}

Errors and limitations

invalid_input: notion rejected the request: body.filter.value should be "page" or "data_source"example: {"body":{"query":"roadmap","filter":{"property":"object","value":"page"},"page_size":10},"max_pages":1}
empty_results: notion returned no results, which usually means nothing is shared with the connection yetIn Notion, open the page or database, then Connections → add the scrollport integration. Search only sees what has been shared with it.