# Search

Notion

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

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. 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](https://scrollport.com/tools/notion-mcp)

**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

`body` object · optional

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

`max_pages` integer · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 10

### Output

`pages` number

Returned pages value.

`results` array

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.

---

Canonical page: https://scrollport.com/tools/providers/notion/search