A Model Context Protocol server that connects Claude and other AI assistants to your Notion workspace, allowing AIs to interact with databases, pages, and blocks.
A Model Context Protocol (MCP) server that connects Claude and other AI assistants to your Notion workspace. This integration allows AI assistants to interact with your Notion databases, pages, and blocks.
This tool acts as a bridge between AI assistants (like Claude) and your Notion workspace. It allows the AI to: - View and search your Notion databases - Create and update pages - Manage content blocks - And much more!
secret_)Option A: Download as ZIP (Recommended for beginners) 1. Go to the GitHub repository: https://github.com/Sjotie/notionMCP/ 2. Click the green "Code" button at the top right 3. Select "Download ZIP" 4. Once downloaded, extract the ZIP file to a location on your computer - Windows: Right-click the ZIP file and select "Extract All" - Mac: Double-click the ZIP file to extract
Option B: Clone with Git (For users familiar with Git)
1. Open a command prompt or terminal
- Windows: Press Win+R, type cmd, and press Enter
- Mac: Open Terminal from Applications > Utilities
2. Navigate to where you want to store the repository
cd path/to/desired/locationgit clone https://github.com/Sjotie/notionMCP/After downloading or cloning, you need to navigate to the project folder using the cd (change directory) command:
If you downloaded the ZIP (Option A):
1. Open a command prompt or terminal
2. Use the cd command to navigate to where you extracted the ZIP file:
cd path/to/extracted/folder/notionMCPFor example:
- On Windows: cd C:UsersYourNameDownloads
otionMCP
- On Mac: cd /Users/YourName/Downloads/notionMCP
If you cloned with Git (Option B): 1. The repository should have been cloned into a folder named "notionMCP" 2. If you're still in the same terminal window after cloning, simply type:
cd notionMCPHow to know you're in the right directory:
- After using the cd command, you can check your current location:
- On Windows: Type dir and press Enter - you should see files like server.js
- On Mac: Type ls and press Enter - you should see files like server.js
Once you're in the notionMCP directory, install the required dependencies:
npm installThis will install all the necessary Node.js packages. You should see a progress bar and eventually a message indicating the installation is finished. It might say something along the lines of "X Packages are looking for funding" - this is completely normal and means it worked.
For security, Notion requires you to explicitly grant access to each page or database:
%APPDATA%Claudeclaude_desktop_config.json
(Type this path in File Explorer address bar)Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
(In Finder, press Cmd+Shift+G and paste this path)
Open the file in a text editor. If it does not exist, create it with the following content:
{
"mcpServers": {
"notion": {
"command": "node",
"args": [
"C:pathtonotion-mcp-serverserver.js"
],
"env": {
"NOTION_API_KEY": "your_notion_api_key_here"
}
}
}
}Replace:
C:pathtonotion-mcp-serverserver.js with the actual path to the server.js fileyour_notion_api_key_here with your Notion API key
Save the file and restart Claude Desktop
The server provides these tools to AI assistants:
Ensure Node.js is installed
"Access denied" when accessing Notion content
Check that your API key has the necessary permissions
Server will not start
npm install)If you encounter issues not covered here, please: - Check the console output for error messages - Ensure your Notion API key is valid - Verify that your integration has access to the pages/databases
MIT