Overview
What is Notion MCP Server?
A Model Context Protocol (MCP) server that integrates with the Notion API, enabling Claude and other LLMs to search, read, create, update, and manage pages, databases, and database entries in a user’s Notion workspace.
How to use Notion MCP Server?
Clone the repository, install dependencies (npm install), build the server (npm run build), and run it (npm start). You must configure a Notion API key (obtained from the Notion Developers portal) either in a .env file or passed directly to the server. For use with Claude for Desktop, add the server to claude_desktop_config.json with the command node and the path to the built server plus the --notion-api-key argument.
Key features of Notion MCP Server
- Search across your entire Notion workspace
- Retrieve content from a specific Notion page
- Create new pages with custom content and titles
- Update existing pages (content and title)
- Create new databases with custom properties
- Query databases with filters and sorting
- Update properties of database entries
- Add new rows to existing databases
Use cases of Notion MCP Server
- Search for meeting notes or project files across your Notion workspace
- Create a new Notion page for a weekly report with structured tasks
- Update a database entry’s status, priority, or due date
- Add a new row to a task tracker database with custom properties
FAQ from Notion MCP Server
How do I set up the server with Claude for Desktop?
Open the Claude for Desktop configuration file (on macOS at ~/Library/Application Support/Claude/claude_desktop_config.json) and add the Notion server entry with the command node, the path to the built index.js, and your Notion API key as --notion-api-key=YOUR_KEY.
What dependencies or runtime are required?
You need Node.js and npm installed. The README instructs to run npm install and npm run build before starting the server.
How do I troubleshoot if tools are not appearing?
Check the Claude for Desktop logs with tail -n 20 -f ~/Library/Logs/Claude/mcp*.log. Ensure your Notion API key is correct and that your integration has been granted access to the relevant pages or databases.
What data operations are supported?
The server supports eight tools: search, get page, create page, update page, create database, query database, update database entry, and create database row. Each requires the appropriate Notion IDs (page or database) and properly formatted properties following the Notion API.
How are authentication and credentials handled?
Authentication uses a Notion internal integration secret (API key). This key can be passed via the --notion-api-key command‑line argument when starting the server, or set in the .env file. The server communicates with the Notion API using the MCP protocol over standard I/O.
