Notion MCP Server: Connect AI to Your Workspace

In this guide

1. What a Notion MCP server does
2. Use cases
3. How to set it up
4. Available tools
5. Security and permissions
6. FAQ

What a Notion MCP server does

Notion is where teams store knowledge — meeting notes, project trackers, wikis, roadmaps. A MCP server makes all of that accessible to your AI assistant without opening the app.

• "Find the Q2 marketing plan" — searches your workspace and returns the page content
• "Create a meeting notes page for today's product review" — creates a new page with a template structure
• "What's the status of the website redesign project?" — queries your project tracker database
• "Add a row to the content calendar: blog post about MCP servers, due Friday" — inserts a database entry
• "Summarize all the decisions from last week's leadership meeting notes" — reads the page and extracts key points
• "Update the status on the Acme onboarding task to Complete" — modifies a database property

Use cases

Knowledge retrieval

Find anything in your workspace without remembering where it lives. Ask for process docs, past decisions, project context, or team information. The AI searches across all shared pages and returns what you need.

Project management

Update task statuses, add new items to trackers, and query project databases without opening Notion. Ask "what's overdue?" or "what did the team ship last week?" and get instant answers from your actual project data.

Content creation

Create new pages with structured content. Draft meeting notes before meetings start. Generate templates. The AI creates the page in Notion directly — no copy-pasting.

Reporting

Pull data from Notion databases to generate summaries. "How many tasks were completed this sprint?" or "Which projects are blocked?" — the AI queries your trackers and synthesizes the answer.

How to set it up

Step 1: Create a Notion integration

Go to notion.so/my-integrations and create a new internal integration. Choose the capabilities you need:

• Read content — search and read pages/databases
• Update content — edit existing pages and database entries
• Insert content — create new pages and entries

Copy the Internal Integration Secret (ntn_...).

Step 2: Share pages with the integration

This is Notion's security model: integrations can only access pages explicitly shared with them. Go to each page or database you want AI to access, click "..." → "Connections" → add your integration.

Tip: share a parent page and all child pages inherit access.

Step 3: Add to your AI client

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_your-token\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

Step 4: Test it

Restart your AI client and ask "Search Notion for meeting notes" or "What pages do I have access to?"

Available tools

• search — full-text search across all shared pages and databases
• get_page — read a specific page's content
• create_page — create a new page with content blocks
• update_page — modify page properties
• query_database — filter and sort database entries
• create_database_entry — add a new row to a database
• get_block_children — read the content blocks of a page
• append_block_children — add content to an existing page

Security and permissions

Notion's integration model is inherently scoped — the AI can only see what you explicitly share:

• Share selectively. Don't share your entire workspace. Start with a few pages or databases.
• Use read-only capabilities first. Only enable "Update" and "Insert" when you're ready for AI to modify content.
• Child pages inherit access. If you share a parent page, all subpages become accessible. Be aware of the tree structure.
• One integration per use case. Create separate integrations for different AI tools or workflows.
• Revoke access anytime. Remove the integration from a page's Connections to cut access immediately.

Related guides

• What Is an MCP Server? — start here if MCP is new
• Slack MCP Server — AI-powered messaging and alerts
• HubSpot MCP Server — connect AI to your CRM