ipIterPrompt
MCP serverKnowledge & MemoryVerified Last verified 2026-07-24

Notion MCP Server

by Notion

Notion's official MCP server connects an AI agent to your Notion workspace so it can search, read, create, and update pages and databases. Notion recommends its remote hosted endpoint (no infrastructure to run), and also publishes an open-source server you can self-host via npm.

Works with

The Model Context Protocol (MCP).

When to use it

  • Turning notes or specs in Notion into drafts, tasks, or summaries
  • Letting an agent file its output straight into the right Notion database
  • Answering questions grounded in your team's Notion knowledge base

When not to

  • Granting broad workspace access when only a single database or page is needed

What it does

  • Search and read pages and databases
  • Create and update pages and database entries
  • Work with comments and structured properties

How to install

Setup steps with copy-paste config. Sources are cited under each method.

Remote server (OAuth)

Requires: An MCP host that supports remote servers · A Notion account

  1. Add the hosted endpoint

    Point your host at Notion's remote MCP endpoint and authorize with OAuth — nothing to install or update.

    url
    https://mcp.notion.com/mcp
  2. Authorize and pick pages

    Complete the OAuth flow and grant the integration access to only the pages/databases the agent should touch.

Self-hosted (npx)

Requires: Node.js · A Notion internal integration token

  1. Add to your MCP config

    Run the open-source server locally with an integration token that has access to the pages you share with it.

    json
    {
      "mcpServers": {
        "notion": {
          "command": "npx",
          "args": ["-y", "@notionhq/notion-mcp-server"],
          "env": { "NOTION_TOKEN": "ntn_your-token" }
        }
      }
    }

How to prompt it

Copy-paste prompts written to exercise this plugin, with what to expect.

Draft into a database

You want meeting notes turned into tracked action items.

From the 'Weekly Sync' page, extract action items and create one entry per item in the Tasks database with owner and due date filled in.

What to expect: The agent reads the page and writes structured entries into the right database, rather than returning plain text you re-enter by hand.

  • Share only the specific database with the integration so writes land in the correct place.

Tips for getting the most out of it

  • The remote endpoint stays current automatically; the self-hosted server gives you full control over the token and network.
  • Notion integrations only see pages you explicitly share with them — scope tightly.

Prompts to pair with it

Real prompts from the IterPrompt library you can copy or run.

Meeting Notes → Decisions & Actions

Turn a raw transcript into decisions, action items with owners, and open questions.

4,650 copiesOpen ↗

Changelog & Release Notes Writer

Turn merged PRs into release notes users actually read.

1,740 copiesOpen ↗

Note-Taking assistant

Turn any AI chat into a note-taking assistant with this community persona prompt.

271 copiesOpen ↗

Note-Taking Assistant

Turn any AI chat into a note-taking assistant with this community persona prompt.

3,225 copiesOpen ↗

Markdown Notes

Turn any AI chat into a markdown notes with this community persona prompt.

3,158 copiesOpen ↗

Ultra-Realistic Handwritten Hospital Note Image

Turn any AI chat into an ultra-realistic handwritten hospital note image with this community persona prompt.

503 copiesOpen ↗
See more prompts in the library

Frequently asked questions

Remote or self-hosted?+

Notion recommends the remote endpoint for most users (no setup, auto-updated). Self-hosting suits teams that need to keep the token and traffic in-house.

Pairs well with

Related guides

Alternatives to Notion MCP Server

Sources & verification

The facts on this page and where they come from. Anything unverified is labeled — we'd rather say "unknown" than guess.

Install steps, pricing, and availability change often. Always confirm on the official page before relying on setup details.