Notion icon

Notion

Official

Notion's official hosted MCP server providing secure AI tool access to workspace content including pages, databases, and comments through OAuth authentication.

Notion MCP Server

Notion's official hosted MCP server gives AI tools secure access to your Notion workspace. Connect through simple OAuth to enable your AI assistant to search pages, query databases, read comments, and access workspace content based on your permissions.

Overview

Notion MCP is a remote hosted server (https://mcp.notion.com) that eliminates the need for local installation or API token management. Your AI tool can request live context from your Notion workspace including:

  • Pages: Read page content and metadata
  • Databases: Query and retrieve structured data
  • Comments: Access discussion threads and annotations
  • Search: Find relevant content across your workspace

All access is scoped to your user permissions - the AI can only see what you can see in Notion.

Connection Methods

Method 1: Through Notion App (Easiest)

  1. Open Settings in the Notion app
  2. Go to ConnectionsNotion MCP
  3. Choose your AI tool from the list
  4. Complete the OAuth flow to authorize

This method automatically configures popular AI tools like Claude, ChatGPT, and Cursor.

Method 2: Streamable HTTP (Recommended for Custom Clients)

For AI tools that support remote MCP servers with HTTP transport:

{
  "mcpServers": {
    "Notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

Endpoint: https://mcp.notion.com/mcp

This is the recommended method for web-based AI tools and clients that support streamable HTTP transport.

Method 3: SSE (Server-Sent Events)

For AI tools that use SSE transport:

{
  "mcpServers": {
    "Notion": {
      "type": "sse",
      "url": "https://mcp.notion.com/sse"
    }
  }
}

Endpoint: https://mcp.notion.com/sse

Method 4: STDIO (For Local-Only Clients)

For AI tools that only support local STDIO servers, use the mcp-remote proxy:

{
  "mcpServers": {
    "notionMCP": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
    }
  }
}

This wraps the remote HTTP server in a local STDIO interface that local-only MCP clients can connect to.

Requirements: Node.js 18+ and npx available in PATH

Capabilities

Workspace Search

Search and retrieve content from your Notion workspace using natural language queries. The AI can find relevant pages, databases, and information across your entire workspace.

Example prompts:

  • "Search for all documentation related to our authentication system"
  • "Find meeting notes from last week's sprint planning"
  • "What did we decide about the API redesign?"

Database Operations

Query Notion databases to retrieve and analyze structured information. Access database schemas, filter entries, and aggregate data.

Example prompts:

  • "Show me all high-priority tasks in the engineering database"
  • "List active marketing campaigns with their current status"
  • "What's the schema of our customer database?"

Page Access

Read full page content, properties, and hierarchical structure. Access both top-level pages and nested sub-pages.

Example prompts:

  • "Read the content of our Q4 roadmap page"
  • "Show me all sub-pages under the team handbook"
  • "Get the status property of all pages in the projects folder"

Comments & Discussions

Access comments and discussion threads on pages and databases to understand context and collaboration history.

Example prompts:

  • "Show me all comments on the PRD for feature X"
  • "What feedback did the team give on the architecture proposal?"

Use Cases

Documentation Creation: Generate PRDs, tech specs, and architecture docs by pulling context from existing Notion pages

Task Management: Query task databases, identify overdue items, and generate reports on project status

Campaign Planning: Track marketing campaigns, analyze progress, and build status reports from Notion databases

Knowledge Discovery: Search across workspace to find relevant information, meeting notes, and decisions

Release Management: Compile release notes by aggregating information from changelogs and feature pages

Authentication

Notion MCP uses OAuth 2.0 for secure authentication:

  1. User initiates connection through their AI tool or Notion app
  2. OAuth flow prompts for workspace authorization
  3. User approves access with specific permissions
  4. AI tool receives scoped access token
  5. All requests use token for authenticated access

Security: The AI tool can only access content that the authenticated user has permission to view. No workspace-wide access is granted beyond user permissions.

Troubleshooting

AI Tool Cannot Connect

Problem: Connection fails or Notion MCP doesn't appear in tool directory

Solutions:

  • Verify your AI tool supports MCP clients
  • Check if tool supports remote MCP servers (HTTP/SSE)
  • For STDIO-only tools, use mcp-remote proxy configuration
  • Request MCP support from your tool's developers if unavailable

OAuth Flow Issues

Problem: Authorization fails or workspace access denied

Solutions:

  • Use Notion app Settings > Connections > Notion MCP for easiest setup
  • Disable popup blockers during OAuth flow
  • Verify you have appropriate workspace permissions
  • Try disconnecting and reconnecting

Limited Content Access

Problem: Cannot see specific pages or databases

Solutions:

  • Access is based on your Notion permissions - verify you can see content in Notion app
  • Check workspace sharing settings for restricted content
  • Ensure pages aren't in private sections
  • Contact workspace admin for broader access if needed

STDIO Connection Issues

Problem: mcp-remote fails or connection drops

Solutions:

  • Prefer HTTP or SSE transport if your tool supports it
  • Ensure Node.js and npx are installed for STDIO
  • Check network connectivity to mcp.notion.com
  • Verify command: npx -y mcp-remote https://mcp.notion.com/mcp

Additional Resources

Use Notion MCP Server with

5ire

Open source cross-platform desktop AI assistant with native MCP server support for enhanced tool integration.

desktopopen-source+1

Claude.ai

Anthropic's official web client with MCP server integration for enhanced AI assistant capabilities and tool connectivity.

anthropicweb-client+1

Claude Desktop App

Official Claude desktop application with built-in MCP support and comprehensive server management capabilities

anthropicdesktop-app+1

Cline

Advanced agentic coding VS Code extension that leverages MCP servers for powerful development tools and automation

vscodecoding-assistant+1

Continue

Open-source development copilot for VS Code and JetBrains IDEs with comprehensive MCP integrations and extensible architecture

open-sourceide-extension+1

Cursor

Advanced AI-powered IDE with comprehensive MCP support for tools and resources, designed for modern development workflows

ideai-powered+1

Daydreams Agents

Innovative agentic platform with Model Context Protocol support for building and deploying autonomous AI agents

agentsplatform+1

Emacs MCP

Community-driven Emacs integration packages for Model Context Protocol support and tool integration

emacseditor+1

fast-agent

Ultra-lightweight agent framework with Model Context Protocol support designed for high-performance AI agent deployment

agent-frameworklightweight+1

FLUJO

Open-source MCP Hub and Inspector with multi-model workflow orchestration and intuitive chat interface

open-sourceworkflow+1

AgentAI

Rust library for simplified AI agent creation with built-in MCP integration and high-performance async capabilities.

rustlibrary+1

Genkit

Google's powerful Genkit framework with comprehensive MCP support for building AI-powered applications and workflows

googleframework+1

Glama

Comprehensive MCP directory, client listings, and community hub for discovering and sharing MCP resources

directorycommunity+1

GenAIScript

Microsoft's powerful scripting framework with comprehensive MCP client integration for AI-powered automation and scripting

microsoftscripting+1

Goose

Open-source development agent with comprehensive MCP integration and intelligent IDE automation capabilities

open-sourcedev-agent+1

gptme

Versatile terminal and chat client with comprehensive MCP support for both local and hosted AI models

terminalchat-client+1

HyperAgent

Playwright-powered autonomous web agent with comprehensive MCP tools integration for automated web interactions

web-automationplaywright+1

JetBrains AI Assistant

JetBrains AI Assistant with full MCP client and server support. Connect to external MCP servers for enhanced AI capabilities, or expose 25+ IDE tools to external clients like Claude Desktop and Cursor.

IDEAI Integration+2

Klavis AI

Open-source MCP integration platform that connects AI agents to 100+ tools (GitHub, Slack, Notion, etc.) with enterprise-grade OAuth and intelligent context management. YC-backed, SOC 2 compliant.

platformintegration+2

LibreChat

Self-hosted, open-source ChatGPT-style UI with comprehensive MCP support, multi-model AI integration (OpenAI, Anthropic, Google, AWS), agents, code interpreter, and enterprise features. Fully customizable and privacy-focused.

web-appself-hosted+2

Lutra AI

First MCP-compatible client built for everyone. AI task agent that connects all your work apps, turns conversations into automated workflows, and integrates with MCP servers seamlessly. No-code automation platform.

workflow-automationno-code+2

AgenticFlow

No-code platform for building intelligent agents that connect thousands of APIs and tools via Model Context Protocol integration

no-codeagent-builder+1

mcp-agent

Simple, composable Python framework to build production-ready AI agents using MCP. Pairs Anthropic Building Effective Agents patterns with MCP runtime, supports multiple LLM providers, and includes Temporal-based orchestration for workflows.

frameworkpython+2

mcp-use

Open-source library to connect any LLM to any MCP server in 6 lines of code. Language-agnostic protocol supporting Python and TypeScript with LangChain.js compatibility, HTTP/SSE transport, and everything needed to build with MCP servers/clients and AI agents.

librarypython+3

MCPHub (mcp.nvim)

Neovim plugin to manage and use MCP servers within the editor. Features intuitive UI for managing server states, marketplace integration for exploring MCP servers, interactive testing, and integration with Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim.

editor-pluginneovim+2

MCPOmni-Connect

Versatile CLI client for MCP with agentic and orchestrator capabilities. Supports chat mode, autonomous agents, planner-based orchestration, treats each MCP server as tool agent, multi-agent workflows, and can be embedded in FastAPI or backend systems.

cliagent-framework+3

Memex

All-in-one desktop app and server builder with prompt-to-MCP server capabilities. Build custom MCP servers from natural language, integrate them instantly, and use them to solve problems—all within a single conversation.

desktop-appdeveloper-tools+2

MindPal

No-code platform for AI agents and workflows with comprehensive MCP support. Build custom AI agents trained on your data, create multi-agent workflows, and connect to 1,000+ business tools—all without writing code.

no-codeworkflow-automation+2

MooPoint

Web-based, model-agnostic AI chat platform with comprehensive MCP server integration, tool calling capabilities, and OAuth support. Connect to any LLM provider while maintaining control over your API keys and data.

web-appmulti-model+2

Msty Studio

Privacy-first AI workspace integrating local and online LLMs with comprehensive MCP toolbox. Run models entirely offline or use cloud providers while maintaining complete control over your data and workflows.

desktop-appprivacy-focused+2

NVIDIA Agent Intelligence Toolkit

Enterprise-grade toolkit for building AI agents with MCP client/server support. Works with LangChain, LlamaIndex, CrewAI, and Semantic Kernel. Includes observability, profiling, and hyperparameter tuning. Part of NVIDIA NeMo family.

platformframework+2

Amazon Q CLI

Amazon's AI-powered coding assistant for terminals with comprehensive MCP server support and AWS integration

awscli+1

OpenSumi

AI-native IDE framework for building custom development environments with MCP client support. Powers CodeFuse IDE and CodeBlitz. VSCode plugin compatible, customizable UI, supports containers, Electron, and pure frontend deployments. By Alibaba & Ant Group.

ideframework+2

oterm

A text-based terminal client for Ollama that supports the Model Context Protocol (MCP), allowing interaction with external tools and data sources directly from the CLI.

cliopen-source+2

Postman

The world's leading API platform now includes a native MCP client for testing, debugging, and interacting with MCP servers in a visual environment.

developer-toolstesting+2

Roo Code

Open-source AI-powered agentic coding assistant for VS Code with comprehensive MCP server support, multi-file editing, custom modes, and advanced orchestration features. Free to use with any AI model.

VS Code ExtensionAI Coding Assistant+2

Slack MCP Client

An open-source TypeScript client that bridges Slack with the Model Context Protocol, enabling users to interact with MCP tools directly within Slack channels and DMs.

chatintegration+2

Sourcegraph Cody

An advanced AI coding assistant that leverages the Model Context Protocol (via OpenCtx) to fetch context from external sources like issue trackers, databases, and documentation.

coding-assistantide-extension+2

SpinAI

A lightweight, observable TypeScript agent framework designed for building production-grade AI agents that can easily consume Model Context Protocol (MCP) tools.

frameworktypescript+2

Superinterface

A comprehensive developer platform and infrastructure for building in-app AI assistants that natively supports the Model Context Protocol (MCP) for tool integration.

platforminfrastructure+2

Superjoin

An AI Assistant for Google Sheets that functions as an MCP Client, allowing users to import data from external sources and automate spreadsheet workflows using natural language.

productivityspreadsheet+2

Theia AI

An open and flexible platform for building AI-enhanced tools and IDEs, featuring deep integration with the Model Context Protocol to provide rich context to AI agents.

platformframework+2

Apify MCP Tester

Standalone SSE/HTTP client for comprehensive MCP server testing with intuitive chat-like user interface

testingdebugging+1

Theia IDE

The open-source IDE that serves as the reference implementation for Theia AI, offering out-of-the-box support for the Model Context Protocol (MCP).

ideopen-source+2

Tome

A sleek macOS desktop client by Runebook that simplifies the management of local LLMs and Model Context Protocol (MCP) servers for non-technical users.

desktop-appmacos+2

TypingMind

A versatile web and desktop frontend for LLMs that supports the Model Context Protocol via a local bridge connector, allowing web-based agents to access local tools.

frontendweb-app+2

Warp

A modern, Rust-based terminal that integrates with Claude Code and the Model Context Protocol to bring AI agent capabilities directly into your command-line workflow.

terminalcli+2

WhatsMCP

Connect your personal AI stack and MCP servers directly to WhatsApp. Manage tools, agents, and workflows through a familiar chat interface.

messagingmobile+2

Windsurf Editor

The first agentic IDE, powered by Codeium. Features deep context awareness and native MCP support to connect to your external tools and data.

idedeveloper-tools+2

Witsy

A powerful desktop AI assistant for macOS and Windows. Supports local LLMs (Ollama) and cloud providers (OpenAI, Anthropic), with a native plugin system built on MCP.

desktopproductivity+3

Zed

A high-performance, multiplayer code editor from the creators of Atom. Features built-in MCP support to connect AI assistants to your codebase and external tools.

idedeveloper-tools+3

Zencoder

An AI coding agent and IDE that integrates with your entire software development lifecycle. Features a built-in MCP library for one-click tool installation.

idedeveloper-tools+3

Augment Code

Agentic code assistant that orchestrates MCP servers for repository-level tasks with intelligent automation

code-assistantautomation+1

Raycast MCP Extension

A Raycast extension that bridges the Model Context Protocol with Raycast AI. Access your MCP tools directly from the Raycast launcher and Quick AI.

launcherproductivity+3

LM Studio

A desktop application for discovering, downloading, and running local LLMs. Version 0.3.17+ includes native support for MCP, allowing local models to use tools.

desktoplocal-llm+3

Perplexity

Native macOS integration enabling Perplexity to connect with local apps and data (Notes, Calendar, Files) via the Model Context Protocol using the PerplexityXPC helper.

desktop-appsearch+2

ChatMCP

An open-source, feature-rich desktop chat client built with Flutter that implements the Model Context Protocol, featuring an integrated MCP server marketplace and multi-LLM support.

desktop-appopen-source+2

MCP Inspector

The official web-based debugging tool for Model Context Protocol servers, allowing developers to test tools, resources, and prompts interactively.

developer-toolstesting+3

mcphub.nvim

Neovim plugin to manage, test, and use MCP servers within the editor. Integrates seamlessly with AI chat plugins like Avante.nvim, CodeCompanion.nvim, and CopilotChat.nvim.

neovimide+2

Bolt.new

AI-powered full-stack development platform that creates stunning apps and websites through conversational AI, with native MCP server integration for extensible capabilities.

web-developmentai-powered+3

Rovo Dev CLI

An AI agent built by Atlassian for software developers, bringing AI-assisted development directly to the command line interface.

cliai-assistant+1

Toolprint

Build AI Agents that use tools 10x Better. A single SDK with powerful capabilities to teach and improve tool selection to achieve workflow goals.

ai-agentstool-management+2

Microsoft Copilot Studio

Low-code platform for building custom AI copilots and agents with MCP integration. Connect existing knowledge servers and data sources directly within Copilot Studio to extend agent capabilities.

enterpriselow-code+2

BeeAI Framework

Open-source framework with comprehensive MCP support for building sophisticated AI workflows and automations

frameworkai-workflows+1

GitHub Copilot (VS Code)

AI-powered code completion and chat in Visual Studio Code with native Model Context Protocol support. Access external tools and data sources through MCP to enhance code generation and assistance.

idecode-editor+2

Amp

Frontier coding agent for terminal and editor with multi-model support (Claude, GPT-5), native MCP integration, thread-based conversations, and extensions for VS Code, Cursor, JetBrains, and Neovim.

clieditor-extension+2

OpenCode

Open-source AI coding agent for the terminal with native MCP support, Plan/Build modes, undo/redo capabilities, and conversation sharing. Supports multiple LLM providers.

cliopen-source+2

BoltAI

Native macOS desktop AI application with comprehensive MCP integrations for both local and cloud-based AI models

macosdesktop-app+1

Claude Code

Anthropic's official AI coding assistant CLI and terminal application with comprehensive MCP support and development tools

anthropiccli+1
Sponsored
Algolia Inc logo

Algolia Inc

“I can't code” is no longer an excuse. The technical barrier is gone. What will you create first?

Try Algolia MCP