# Notion — MCP Server

> Search, summarise and edit your Notion workspace with AI.

**Source:** https://mcpplaygroundonline.com/mcp-servers/notion  
**Transport:** http  
**Requires auth:** Yes

---

## What it does

The Notion MCP server exposes the Notion API as MCP tools — searching across pages by query, reading page content as structured blocks, querying databases with filters, creating or updating pages, and managing comments. Models can answer "find the latest engineering RFC about X", summarise a project doc, draft a new page from a template, or roll up a database into a status report. Because Notion runs the server, there is no infrastructure to manage — only an integration token to provision.

## Tools exposed

- search — full-text search across pages and databases
- get_page — read page content as structured blocks
- query_database — filter, sort and paginate database rows
- create_page — create a new page or database row
- update_page — patch page properties or append blocks
- list_comments / create_comment — read or post comments

## Example queries you can run

- "Search my workspace for the latest doc about Q2 planning and summarise it."
- "Find every page tagged "RFC" updated in the last 14 days and list the authors."
- "Create a new page in the Engineering wiki titled "Onboarding 2026" with these sections."
- "Summarise the comments on this page and tell me what is unresolved."

## Details

- **Recommended model:** anthropic/claude-sonnet-4.5 — Claude Sonnet 4.5 handles long doc summarisation and multi-step Notion search well. Use Haiku for cheap quick searches; GPT-5.2 for creative writing into pages.
- **Transport:** http
- **Authentication:** Required — Notion integration token. Create one at notion.so/profile/integrations, then share the pages or databases you want the agent to access.
- **Hosted endpoint:** https://mcp.notion.com/mcp
- **Official source:** [Notion MCP docs](https://developers.notion.com/docs/mcp)

## Frequently asked questions

### What is the Notion MCP server?

It is an official MCP server hosted by Notion at mcp.notion.com/mcp. It exposes the Notion API as tools an AI model can call — searching, reading, creating and editing pages and databases in your workspace.

### How do I get a Notion integration token?

Go to notion.so/profile/integrations, create a new internal integration, and copy the secret. Then open the pages or databases you want the agent to see, click Share → Add connections, and select your integration.

### Can the Notion MCP server write to my workspace?

Yes — it can create pages, update properties and post comments, but only on pages your integration has been explicitly shared with. Notion enforces this at the API level, so you can scope an agent to a single database if you want.

### Is the Notion MCP server free?

Yes, the MCP server is free to use with any Notion plan that supports integrations. AI model costs are billed separately by your model provider, or covered by your MCP Agent Studio credits if you run it in-browser.

### Which model is best for Notion knowledge work?

For long-doc summarisation and multi-step research, Claude Sonnet 4.5 is the most reliable. For quick lookups and high-volume search, Claude Haiku 4.5 or GPT-5.2 mini are cheaper. Compare them on your own pages in Agent Studio.

---

_Test this server across 40+ models on MCP Playground: https://mcpplaygroundonline.com/mcp-servers/notion — free, no install._