Notion MCP Server

What is Notion MCP Server?

A Model Context Protocol server for Notion integration that allows Claude and other LLMs to interact with a Notion workspace through tools like search, page management, and database operations.

How to use Notion MCP Server?

Clone the repository, install dependencies with npm install, configure your Notion API key (via .env or Claude for Desktop config), build with npm run build, and start with npm start. For Claude for Desktop, add the server configuration to claude_desktop_config.json and restart the application.

Key features of Notion MCP Server

• Search across your entire Notion workspace
• Retrieve content from a specific Notion page
• Create new pages in your Notion workspace
• Update existing pages with new content or titles
• Create databases with custom properties
• Query databases with filters and sorting

Use cases of Notion MCP Server

• Search for meeting notes across your Notion workspace
• Get the content of a project planning page by its ID
• Create a new page with a list of tasks in Notion
• Update an existing page with new content or a new title
• Query a Notion database for items with status "Completed"

FAQ from Notion MCP Server

How do I configure my Notion API key?

Create an integration in the Notion Developers portal, copy your API key, and either edit the .env file or pass it via the --notion-api-key argument in the Claude for Desktop configuration.

How do I integrate this server with Claude for Desktop?

Add the server configuration to your Claude for Desktop config file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS) with the command, path to the built script, and your Notion API key, then restart Claude for Desktop.

What tools are available in this server?

The server provides tools for searching, getting page content, creating pages, updating pages, creating databases, querying databases, updating database entries, and creating database rows.

How do I troubleshoot if tools aren't showing up?

Check the Claude for Desktop logs using tail -n 20 -f ~/Library/Logs/Claude/mcp*.log. Ensure your Notion API key is correctly set and that your integration has been granted access to the relevant pages.

What prerequisites are needed to run this server?

You need Node.js installed, a Notion API key from the Notion Developers portal, and for use with Claude for Desktop, the Claude for Desktop application.