> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://notion.ferndocs.com/docs/mcp/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://notion.ferndocs.com/_mcp/server.

# Notion MCP

Connect your AI tools to Notion using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction), an open standard that lets AI assistants interact with your Notion workspace.

## What is Notion MCP?

Notion MCP is our hosted server that gives AI tools secure access to your Notion workspace. It's designed to work seamlessly with popular AI assistants like ChatGPT, Cursor, and Claude.

<Frame caption="High-level diagram of the MCP data flow, where Notion hosts both the MCP Server and [Notion's API](/docs/getting-started), and your tools contain [MCP clients](/docs/common-mcp-clients) that connect to the remote MCP server to access our tools.">
  <img src="https://files.readme.io/97125b4c4172e71d0a2293523ebf17424f7fec9fab5852d4b6c0eba2eaa0200d-image.png" alt=""/>
</Frame>


### Why use Notion MCP?

- **Easy setup** — Connect through simple OAuth, with one-click installation for supported AI tools
- **Full workspace access** — AI tools can read and write to your Notion pages just like you can
- **Optimized for AI** — Built specifically for AI agents with efficient data formatting

### What can you do with Notion MCP?

- **Create documentation** — Generate PRDs, tech specs, and architecture docs from your research and project data
- **Search and find answers** — Let AI search across all your Notion and connected workspace content
- **Manage tasks** — Generate code snippets from task descriptions and update project status automatically
- **Build reports** — Create release notes, project updates, and performance reports from multiple sources
- **Plan campaigns** — Generate comprehensive briefs and track progress across marketing channels

> Learn how to connect AI agents to your Notion workspace.

## Docs

- [Connecting to Notion MCP](https://notion.ferndocs.com/docs/get-started-with-mcp.md): Learn how to get started and plug Notion into your AI tool.
- [Supported tools](https://notion.ferndocs.com/docs/mcp-supported-tools.md): Learn what you can do with Notion MCP tools.
- [Security best practices](https://notion.ferndocs.com/docs/mcp-security-best-practices.md): Learn how to keep your workspace secure when using Notion MCP.
- [Hosting a local MCP server](https://notion.ferndocs.com/docs/hosting-open-source-mcp.md): Learn how and when to use the open-source Notion MCP server.
- [Common MCP clients](https://notion.ferndocs.com/docs/common-mcp-clients.md):