# Notion (MCP Server)

> Search, read, and write Notion pages, databases, and comments via hosted MCP

- Type: MCP server
- Publisher: Notion (official)
- Categories: Productivity, Writing
- Website: https://developers.notion.com/guides/mcp/get-started-with-mcp
- Docs: https://developers.notion.com/guides/mcp/mcp-supported-tools
- Source: https://github.com/makenotion/notion-mcp-server
- Transport: streamable-http
- Server URL: https://mcp.notion.com/mcp
- Launch command: npx -y @notionhq/notion-mcp-server
- Sign-in: oauth
- GitHub stars: 4700
- Listed: 2025-07-01

## About

Notion's official hosted MCP server lets AI clients search a workspace, fetch pages, create and update pages and databases, and work with comments, views, and meeting notes. It authenticates with OAuth and is the actively supported option; the older self-hosted @notionhq/notion-mcp-server package is no longer actively maintained.

## Install

1. **Connect it in ChatGPT** Turn on Developer mode in ChatGPT (Settings → Security and login), open Plugins, select + and paste https://mcp.notion.com/mcp as the MCP server URL, then sign in with OAuth. Add it to a chat from the composer's tools menu.

2. **Or add it to Codex or the API**

   Codex CLI:

   ```bash
   codex mcp add notion --url https://mcp.notion.com/mcp
   codex mcp login notion
   ```

   config.toml:

   ```toml
   [mcp_servers.notion]
   url = "https://mcp.notion.com/mcp"
   ```

   Responses API:

   ```python
   import os
   from openai import OpenAI
   
   client = OpenAI()
   
   response = client.responses.create(
       model="gpt-6-astra",
       tools=[{
           "type": "mcp",
           "server_label": "notion",
           "server_url": "https://mcp.notion.com/mcp",
           "authorization": os.environ["NOTION_API_KEY"],
           "require_approval": "never",
       }],
       input="Find my notes from last week's planning meeting in Notion",
   )
   print(response.output_text)
   ```

## Tools

- `notion-search`
- `notion-fetch`
- `notion-create-pages`
- `notion-update-page`
- `notion-move-pages`
- `notion-duplicate-page`
- `notion-create-database`
- `notion-update-data-source`
- `notion-query-data-sources`
- `notion-create-comment`
- `notion-get-comments`
- `notion-get-users`

## Example prompts

- "Find my notes from last week's planning meeting in Notion"
- "Create a project brief page under the Engineering teamspace"
- "Add a row to the Roadmap database for the new onboarding feature"
- "Summarize the comments on the Q3 OKRs page"

## Related

- [Excalidraw](https://chatgptplugins.directory/mcp/excalidraw.md): Draw hand-drawn Excalidraw diagrams live inside ChatGPT, Claude and VS Code
- [Atlassian Rovo (Jira & Confluence)](https://chatgptplugins.directory/mcp/atlassian-rovo.md): Work with Jira issues and Confluence pages through Atlassian's hosted MCP
- [Browser Use](https://chatgptplugins.directory/mcp/browser-use.md): Run Browser Use cloud browser agents or control a local browser over MCP
- [Filesystem](https://chatgptplugins.directory/mcp/filesystem.md): Secure local file operations with configurable directory access
- [Memory](https://chatgptplugins.directory/mcp/memory.md): Knowledge graph-based persistent memory across conversations
- [Mem0](https://chatgptplugins.directory/mcp/mem0.md): Hosted long-term memory for AI agents and clients

---
Source: https://chatgptplugins.directory/mcp/notion · Index: https://chatgptplugins.directory/llms.txt · Independent and community-run. Not affiliated with or endorsed by OpenAI. ChatGPT is a trademark of OpenAI.