MCP/Notion MCP Server
Notion MCP Server logo

Notion MCP Server

Verified Golden (1000+ GitHub stars)

Connects AI coding assistants and agents to Notion workspaces to search pages, query databases, read/update blocks, and manage data sources.

developer-tools•Productivity & Knowledge Base
GitHub4.7k
License:MIT
VERIFIED
ByNotion@Notion

About this Server

The official Notion Model Context Protocol (MCP) server allows AI assistants (Claude, Cursor, Copilot, VS Code) to read, search, create, and update Notion pages, databases, and structured data sources. Agents can query databases with granular filters and sorting, update page content and metadata, retrieve schemas, move pages across workspace hierarchies, and interact seamlessly with project roadmaps and documentation hubs.

Real-time Interaction

Direct low-latency RPC protocol communication with structured JSON schemas.

Scoped Sandboxing

Restricted capability bounds to prevent accidental modifications or leakage.

Security & Best Practices

Integration Token Scoping: Generate internal integration tokens from notion.so/profile/integrations with minimal required read/write permissions.
Granular Page Sharing: Notion integrations can only access pages and databases explicitly shared with the integration.
Secure Token Storage: Store NOTION_TOKEN inside editor environment variables or secure password inputs rather than committing plain text tokens.

When to Use (and When Not To)

Best For
  • •Searching Notion workspace documentation, architecture decisions, and meeting notes from coding agents
  • •Querying and updating engineering project tasks, sprint backlogs, or product feature tables
  • •Creating documentation pages or test summaries automatically from CI/CD and agent workflows
  • •Reorganizing and moving documentation pages across team spaces and folders
Not For / Limitations
  • •Local code file editing or Git repository tracking (use native file tools or GitHub MCP instead)
  • •Real-time websocket chat or instant messaging (use Slack MCP instead)
  • •Direct raw SQL database migrations (use PostgreSQL, Neon, or Supabase MCP instead)

Install & Setup

terminal command
$claude mcp add notionApi -- npx -y @notionhq/notion-mcp-server

Exposed Tools & Endpoints

7 tools

Functions your AI agent can invoke via this Model Context Protocol server

query-data-source

Queries a Notion database / data source with custom filter criteria, sort configurations, and pagination.

retrieve-a-data-source

Retrieves the schema, properties, and metadata of a specific Notion data source or database.

update-a-data-source

Updates properties, titles, or schema configuration of an existing Notion data source.

create-a-data-source

Creates a new structured Notion data source or database with defined property schemas.

list-data-source-templates

Lists available pre-configured templates within a Notion database or data source.

move-page

Moves an existing Notion page to a new parent location (workspace, parent page, or database).

retrieve-a-database

Gets database metadata including linked data source IDs and workspace references.