Notion
Notion MCP Server
Search, read, and create Notion pages and databases from your AI coding assistant.
Last reviewed Mar 2, 2026
Install
claude mcp add notion --transport stdio -- npx -y @notionhq/notion-mcp-serverEnvironment variables required:
OPENAPI_MCP_HEADERS={"Authorization": "Bearer your-notion-token", "Notion-Version": "2022-06-28"}Available tools
| Tool | Description |
|---|---|
| search | Search across pages and databases in Notion |
| get_page | Retrieve the content of a specific page |
| create_page | Create a new page in a database or as a child page |
| update_page | Update properties or content of an existing page |
| query_database | Query a Notion database with filters and sorts |
What it does
The Notion MCP Server connects your AI coding assistant to your Notion workspace, enabling it to search through documentation, read page contents, create new pages, and query databases. This is invaluable for teams that maintain technical documentation, project specs, or knowledge bases in Notion.
By giving your assistant access to Notion, it can look up design documents, API specifications, or meeting notes to inform code generation. It can also create documentation pages or update project trackers as part of your development workflow.
Use cases
- Search your Notion workspace for design docs, API specs, or architecture decisions while coding
- Look up requirements and acceptance criteria from project pages without leaving your editor
- Create documentation pages for new features or APIs directly from your development environment
- Query project databases to check status, priorities, or assignments
- Update task databases to reflect development progress
Getting started
- Create a Notion Internal Integration at notion.so/my-integrations. Give it a name and select the workspace you want to connect.
- Copy the Internal Integration Token (starts with
ntn_orsecret_). - Share the Notion pages or databases you want the assistant to access with your integration. Open each page, click "..." > "Connections" > select your integration.
- Set the
OPENAPI_MCP_HEADERSenvironment variable with your token in the Authorization header as shown in the install config above.
Compatibility
Related MCP servers
AWS MCP Server
Interact with AWS services including S3, Lambda, CloudWatch, and ECS from your AI coding assistant.
Context7 MCP Server
Fetch up-to-date library documentation and code examples directly into your AI coding assistant.
Docker MCP Server
Manage Docker containers, images, and builds directly from your AI coding assistant.