Notion MCP Server Integration

Connect your AI agent to Notion workspaces for seamless interaction with pages, databases, and data sources. This skill configures the official Notion MCP server, enabling AI-powered content management, queries, and automation.

What This Skill Does

This skill enables AI agents to:

Setup Instructions

Step 1: Create a Notion Integration

1. Navigate to [https://www.notion.so/profile/integrations](https://www.notion.so/profile/integrations)

2. Click "New integration" or select an existing internal integration

3. Configure capabilities based on your security requirements:

- For read-only access: Enable only "Read content"

- For full access: Enable "Read content", "Update content", and "Insert content"

4. Copy the integration token (starts with `ntn_`)

Step 2: Grant Page Access

Choose one of these methods to connect your integration to Notion content:

**Method A: Bulk access (recommended)**

1. Go to your integration settings

2. Click the "Access" tab

3. Click "Edit access" and select the pages/databases to connect

**Method B: Individual page access**

1. Open the target Notion page

2. Click the three dots menu (⋯)

3. Select "Connect to" and choose your integration

Step 3: Configure MCP Client

Add the Notion MCP server to your AI client's configuration file:

#### Claude Desktop / Cursor

Edit `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`) or `.cursor/mcp.json`:

```json

{

"mcpServers": {

"notionApi": {

"command": "npx",

"args": ["-y", "@notionhq/notion-mcp-server"],

"env": {

"NOTION_TOKEN": "ntn_YOUR_TOKEN_HERE"

}

}

}

}

```

#### Zed

Edit `settings.json`:

```json

{

"context_servers": {

"notion": {

"command": {

"path": "npx",

"args": ["-y", "@notionhq/notion-mcp-server"],

"env": {

"NOTION_TOKEN": "ntn_YOUR_TOKEN_HERE"

}

}

}

}

}

```

#### GitHub Copilot CLI

Run interactively:

```bash

/mcp add

```

Or edit `~/.copilot/mcp-config.json`:

```json

{

"mcpServers": {

"notionApi": {

"command": "npx",

"args": ["-y", "@notionhq/notion-mcp-server"],

"env": {

"NOTION_TOKEN": "ntn_YOUR_TOKEN_HERE"

}

}

}

}

```

Step 4: Docker Alternative (Optional)

For containerized environments, use the official Docker Hub image:

```json

{

"mcpServers": {

"notionApi": {

"command": "docker",

"args": [

"run", "--rm", "-i",

"-e", "NOTION_TOKEN",

"mcp/notion"

],

"env": {

"NOTION_TOKEN": "ntn_YOUR_TOKEN_HERE"

}

}

}

}

```

Step 5: Restart Your AI Client

Restart Claude Desktop, Cursor, Zed, or GitHub Copilot CLI to load the MCP server.

Available Tools

Once configured, your AI agent can use these Notion API tools:

Page Operations

Data Source (Database) Operations

Search & Comments

Usage Examples

**Add a comment to a page:**

```text

Comment "Reviewed and approved" on the page titled "Q1 Planning"

```

**Create a new page:**

```text

Add a page titled "Meeting Notes - Feb 2026" to the "Team Meetings" page

```

**Query a database:**

```text

Get all tasks from the "Project Tracker" database where status is "In Progress"

```

**Retrieve page content:**

```text

Get the content of page ID 1a6b35e6e67f802fa7e1d27686f017f2

```

Important Notes

Transport Options

**STDIO (default):** Standard input/output communication for desktop clients

**HTTP (advanced):** For web-based applications:

```bash

npx @notionhq/notion-mcp-server --transport http --port 8080 --auth-token "your-secret"

```

Access at `http://0.0.0.0:8080/mcp` with bearer token authentication.

Troubleshooting

Learn More