Notion MCP Server
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Exposes the official Notion SDK, allowing interaction with Notion workspaces. Provides tools for searching, querying databases, creating and updating pages, managing content blocks, working with users, adding comments, and creating link previews.
Notion MCP Server
A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.
Quick Start
1. Set up your Notion integration
- Go to https://www.notion.so/my-integrations
- Create a new integration
- Copy the API key
2. Add to your AI assistant
You can add this MCP server to Claude Desktop, Cursor AI, or Claude.ai using either of these configuration formats:
Command Line Format
JSON Configuration Format
Replace your-notion-integration-key
with the API key from step 1.
Setup Instructions
- Claude Desktop: Settings > Advanced > Model Context Protocol
- Cursor AI: Settings > AI > MCP Servers
- Claude.ai (Web): Profile > Settings > API & Integrations > Model Context Protocol
Available Tools
The server provides tools for interacting with Notion:
- Search: Find pages or databases
- Databases: Query and retrieve database entries
- Pages: Create, retrieve, and update pages
- Blocks: Manage content blocks (paragraphs, lists, etc.)
- Users: List users and get user information
- Comments: Create and list comments
- Link Previews: Create link previews for URLs
Alternative Setup Methods
Using Environment Variables
Instead of passing the API key directly, you can use a .env
file:
- Create a
.env
file with:
- Run the server:
JSON Configuration with Environment Variables (for Claude Desktop)
You can also use environment variables in the JSON configuration format:
Command Line Options
Troubleshooting
If you encounter "Failed to create client" errors:
- On Windows, try using
cmd /c
before the npx command - On macOS/Linux, try using the full path to npx
- Test the command in a terminal before adding it to your AI assistant
Features
- Full Notion API support through the official SDK
- MCP compliant for seamless AI integration
- Comprehensive tools for all Notion operations
- Robust error handling with detailed messages
- Easy configuration with environment variables
For detailed documentation on each tool, see the Tools Documentation.
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
You must be authenticated.
A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.