Notion MCP Server

by SAhmadUmass

The Notion MCP Server enables Claude and other LLMs to interact with your Notion workspace through the Model Context Protocol. It allows you to search, retrieve, create, and update pages and databases within Notion using natural language.

View on GitHub

Last updated: N/A

What is Notion MCP Server?

The Notion MCP Server is a bridge that connects Large Language Models (LLMs) like Claude to your Notion workspace. It implements the Model Context Protocol (MCP) to allow the LLM to understand and interact with your Notion data.

How to use Notion MCP Server?

Clone the repository and install dependencies using npm install. 2. Configure your Notion API key by creating an integration in the Notion Developers portal and setting the API key. 3. Build the server using npm run build and start it with npm start. 4. Configure Claude for Desktop to connect to the server by adding the server configuration to the claude_desktop_config.json file. 5. Use natural language prompts with Claude to interact with your Notion workspace.

Key features of Notion MCP Server

Search Notion workspace
Retrieve content from a specific Notion page
Create new pages in Notion
Update existing pages with new content or titles
Create new databases with custom properties
Query databases with filters and sorting
Update properties of database entries
Add new rows to existing databases with custom properties

Use cases of Notion MCP Server

Automated note-taking and summarization in Notion
Creating and updating project plans in Notion using natural language
Managing tasks and deadlines in Notion through LLM interactions
Searching for specific information within a large Notion workspace
Generating reports and summaries from Notion databases

FAQ from Notion MCP Server

How do I get my Notion API key?

Create an integration in the Notion Developers portal (https://www.notion.so/my-integrations) and copy the API key.

How do I configure Claude for Desktop to use this server?

Add the server configuration to your claude_desktop_config.json file, specifying the path to the server's index.js file and your Notion API key.

What if the tools aren't showing up in Claude?

Check the Claude for Desktop logs for any errors. Ensure that your Notion API key is correctly set and that your integration has access to the pages you want to interact with.

What kind of queries can I run on my Notion databases?

You can filter and sort database entries based on properties like status, due date, and priority. See the README for examples.

What if I see 'Unexpected token' errors in the logs?

This version of the server has been updated to avoid those issues. Make sure you are using the latest version of the server.