Notion MCP Server
Notion's official MCP server, using an internal integration token to let agents read and work with authorized pages and databases.
Project overview
Notion MCP Server is a MCP server built around notion's official MCP server, using an internal integration token to let agents read and work with authorized pages and databases. Its value is practical: read notion pages and search workspace content are available from one documented project, while the repository remains inspectable before it is added to an agent workflow.
Core capabilities
Read Notion pages
Read Notion pages is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.
Search workspace content
Search workspace content is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.
Work with database entries
Work with database entries is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.
Connect a knowledge base to an agent
Connect a knowledge base to an agent is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.
Setup and connection
Set up Notion MCP Server from its public GitHub instructions, keep the initial permission scope small, and verify it with a low-risk task before regular use.
Let an AI Agent install it
Send this prompt to Codex, Claude Code, or another AI agent that can work with your local environment.
Help me set up Notion MCP Server.
Project URL: https://github.com/makenotion/notion-mcp-server
Read the repository README and license first. Confirm the current host, prerequisites, destination paths, and permissions. Follow the repository's documented method, keep credentials out of files and logs, and start with the least-privilege or read-only option where available. Afterward, run a small verification and report the exact changes, commands, configuration path, and result. Ask before overwriting files or requesting broader access.- Create a Notion internal integration
- Share required pages with the integration
- Node.js and npx
{"mcpServers":{"notion":{"command":"npx","args":["-y","@notionhq/notion-mcp-server"],"env":{"NOTION_TOKEN":"YOUR_NOTION_INTEGRATION_TOKEN"}}}}- 1Review prerequisites and scope
Read the README, confirm the target host, and prepare these prerequisites: Create a Notion internal integration; Share required pages with the integration; Node.js and npx. Check destination paths and permissions before making changes.
- 2Apply the documented setup
Run the documented command: npx -y @notionhq/notion-mcp-server
- 3Verify with a small task
Restart the MCP host and confirm that Notion MCP Server appears in the server list. Call one low-risk read-only tool and check that it returns an expected result without authentication errors.
Restart the MCP host and confirm that Notion MCP Server appears in the server list. Call one low-risk read-only tool and check that it returns an expected result without authentication errors.
- The integration token must be stored as a secret
- Broad integration permissions expand the agent's access
Use cases
Query a team knowledge base
Query a team knowledge base is a practical fit when the repository's documented prerequisites and permission model match the current environment.
Organize project material from Notion
Organize project material from Notion is a practical fit when the repository's documented prerequisites and permission model match the current environment.
Assist with database entries
Assist with database entries is a practical fit when the repository's documented prerequisites and permission model match the current environment.
Assessment
This assessment is based on the repository README, component documentation, license, and maintenance metadata. Maintained by Notion with a documented permission model; Only pages shared with the integration enter its scope. The main trade-offs are also clear: The integration token must be stored as a secret; Broad integration permissions expand the agent's access. No local installation or functional test was claimed during cataloging.
Why it may be useful
- Maintained by Notion with a documented permission model
- Only pages shared with the integration enter its scope
What to know first
- The integration token must be stored as a secret
- Broad integration permissions expand the agent's access
README
Notion MCP Server
Overview
Notion's official MCP server, using an internal integration token to let agents read and work with authorized pages and databases. Notion's official MCP server, using an internal integration token to let agents read and work with authorized pages and databases.
Getting started
- Set up Notion MCP Server from its public GitHub instructions, keep the initial permission scope small, and verify it with a low-risk task before regular use.
- The repository describes Notion MCP Server as notion's official MCP server, using an internal integration token to let agents read and work with authorized pages and databases.
- Its main capabilities include read notion pages, search workspace content, work with database entries, connect a knowledge base to an agent. The documented facts include official notion project, internal integration token, pages require explicit sharing, runs through npx.
- Restart the MCP host and confirm that Notion MCP Server appears in the server list. Call one low-risk read-only tool and check that it returns an expected result without authentication errors.
Configuration
{"mcpServers":{"notion":{"command":"npx","args":["-y","@notionhq/notion-mcp-server"],"env":{"NOTION_TOKEN":"YOUR_NOTION_INTEGRATION_TOKEN"}}}}Read the complete README on GitHub →