How to Set Up the Notion MCP Server for Workspace Integration

Connect your Notion workspace to AI agents. Search pages, read databases, create content, and manage your Notion knowledge base through MCP.

Notionworkspaceknowledge basenotesdatabasesproductivity

Set Up the Notion MCP Server

The Notion MCP server connects AI agents to your Notion workspace, enabling searching, reading, and creating content in your pages and databases.

Prerequisites

▸Notion account with workspace access
▸Notion API Integration token
▸Node.js 18+

Creating a Notion Integration

▸Go to notion.so/my-integrations
▸Click New integration
▸Name it (e.g., "MCP AI Agent")
▸Select your workspace
▸Set capabilities: Read content, Update content, Insert content
▸Copy the Internal Integration Token

Sharing Pages with the Integration

IMPORTANT: You must explicitly share pages/databases with your integration:

▸Open the page or database in Notion
▸Click Share (top right)
▸Search for your integration name
▸Click Invite

Configuration

json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "ntn_your_token_here"
      }
    }
  }
}

Available Tools

▸
code
```
search_pages
```
— Search across all shared pages
▸
code
```
get_page
```
— Retrieve a specific page's content
▸
code
```
create_page
```
— Create new pages
▸
code
```
update_page
```
— Modify existing pages
▸
code
```
query_database
```
— Query Notion databases with filters
▸
code
```
create_database_item
```
— Add items to databases

Example Workflows

Meeting Notes Summary

code

"Search my Notion for all meeting notes from this week and create a summary page"

Project Tracking

code

"Query my Projects database for all items with status 'In Progress' and list their due dates"

Content Creation

code

"Create a new page in my Documentation section outlining the API authentication process"

Knowledge Base Search

code

"Search my Notion for any documentation about our deployment process"

Tips

▸Share entire parent pages to automatically include sub-pages
▸Use Notion databases (tables) for structured data the AI can query
▸The AI can create rich content with headings, lists, and code blocks
▸Regularly review what pages are shared with the integration