Connect Notion MCP to Your AI Agent

Search accessible Notion pages, read Markdown page content, and summarize page comments. Ask your connected AI assistant to explain the results or carry out the specified operation.

5 tools OAuth

Try a Notion MCP Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Notion MCP

Research Related Pages

Search pages, read selected results, and compare their reported content.

/oo Notion MCP: Search Notion for [topic], fetch the relevant page IDs, and summarize their content with page links and any truncation notices.

Summarize Page Discussions

Read a page and its comments to extract open questions.

/oo Notion MCP: Read Notion page [page ID or URL] and list its comments, then summarize decisions and unresolved questions in the returned content.

Start Working with Notion MCP

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Notion MCP

    Connect through Notion MCP OAuth authorization.

    Connect Notion MCP →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A Notion account with access to the target pages.
  • Search features depend on the connected Notion plan. Check notices for dropped filters and truncated flags when reading pages.

Notion MCP Tools

Notion MCP connects supported service operations to your AI assistant. Search accessible Notion pages, read Markdown page content, and summarize page comments.

Page Research

Search pages and fetch Markdown content and properties.

Comments and Access

Read page comments and inspect plan-specific tool access.

5 tools

Get Self

Identify the connected Notion user through notion-get-users with user_id self. Returns the user ID, name, and email the server reports.

notion_mcp.get_self

Search

Search Notion pages through notion-search with optional text, sort, page size, date-range and creator filters. Returns typed results, the search type that ran, the server's notices about dropped filters, and the raw response. Filtering by editor or last-edited date and sorting by date need a Business or Enterprise plan; other plans drop them and name them in notices. When the connection can use AI search, a non-empty keyword query with no exact filter and relevance order runs AI search and can return results from connected apps. Notion allows 30 searches a minute.

notion_mcp.search

Fetch Page

Read one Notion page through notion-fetch by ID or URL. Returns the title, properties block, Markdown content, a truncated flag, and the raw response.

notion_mcp.fetch_page

List Comments

List the comments on one Notion page through notion-get-comments, flattened across discussions. Block-level and resolved discussions are included unless turned off; the server offers no paging.

notion_mcp.list_comments

Tool Access

Report each MCP tool's access status on the connected Notion plan through notion-get-tool-access, keyed by the tool's base name such as search, with the parameters the plan restricts and the reason for each, such as the edited-by search filter below the Business plan.

notion_mcp.tool_access

Frequently Asked Questions

Why was a search filter ignored?

Some editor/date filters and date sorting require Business or Enterprise. Search notices identify dropped filters; tool access reports restrictions.

Can pages be truncated?

Yes. Inspect the truncated flag before assuming the fetched Markdown is complete.

Can I read page discussions?

Yes. The comments action returns page discussions, including block-level and resolved discussions unless excluded.

Connect Notion MCP

About Notion MCP ↗