Overview
What is Notion MCP Server?
A Model Context Protocol (MCP) server that connects Claude and other AI assistants to your Notion workspace. It acts as a bridge, allowing AI to view and search databases, create and update pages, manage content blocks, and more.
How to use Notion MCP Server?
Download or clone the repository, install dependencies with npm install, obtain a Notion API key from my integrations, and grant the integration access to specific pages or databases. Configure the Claude Desktop app by editing claude_desktop_config.json to point to the server and provide the NOTION_API_KEY environment variable. Restart Claude Desktop to start interacting with Notion.
Key features of Notion MCP Server
- View and search accessible Notion databases
- Create, update, and query database entries
- Add, edit, and manage content blocks
- Search content across the entire workspace
- Create and modify database structures
- Retrieve specific pages and blocks
Use cases of Notion MCP Server
- Ask an AI to list all databases in your Notion workspace
- Create a new page in a Tasks database with a specific title
- Update or modify existing pages programmatically
- Search for content across pages and databases
- Append or edit content blocks on a page
FAQ from Notion MCP Server
What are the prerequisites for using Notion MCP Server?
Node.js (version 14 or higher), a Notion account, and the Claude Desktop app (if using with Claude). You also need a Notion API key from the internal integrations page.
How do I get a Notion API key?
Go to my integrations, create a new integration, select your workspace, and copy the "Internal Integration Token" (starts with secret_).
How do I grant the integration access to my Notion content?
In Notion, open a page or database, click the "•••" menu, select "Add connections", and choose your integration. Repeat for all pages or databases you want the AI to access.
How do I connect the server to Claude Desktop?
Edit claude_desktop_config.json (located in %APPDATA%\Claude\ on Windows or ~/Library/Application Support/Claude/ on Mac) to include the server path and your NOTION_API_KEY. Restart Claude Desktop.
What should I do if the server won't start or I get "Connection failed"?
Verify that the server path in the config is correct, your Notion API key is valid, all dependencies are installed (npm install), and that Node.js is installed. Also ensure the integration has been shared with the relevant pages or databases.
