MCP Servers · Publisher repository

Notion MCP Server

Notion's official MCP server, using an internal integration token to let agents read and work with authorized pages and databases.

4.6k StarsMITTypeScriptUpdated 24 days ago
01

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.

02

Core capabilities

01

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.

02

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.

03

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.

04

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.

03

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.

AI AGENT INSTALL

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.
01Before you start
  • Create a Notion internal integration
  • Share required pages with the integration
  • Node.js and npx
02Copy the install command or configuration
{"mcpServers":{"notion":{"command":"npx","args":["-y","@notionhq/notion-mcp-server"],"env":{"NOTION_TOKEN":"YOUR_NOTION_INTEGRATION_TOKEN"}}}}
03Complete the setup steps
  1. 1
    Review 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.

  2. 2
    Apply the documented setup

    Run the documented command: npx -y @notionhq/notion-mcp-server

  3. 3
    Verify 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.

How to verify the setup

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.

Before using it
  • The integration token must be stored as a secret
  • Broad integration permissions expand the agent's access
04

Use cases

SCENARIO 01

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.

SCENARIO 02

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.

SCENARIO 03

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.

05

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
06

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