Ramidecodes MCP Server Notion

🚀 Notion MCP Server

A Model Context Protocol (MCP) server that provides the official Notion SDK, allowing AI models to interact with Notion workspaces.

🚀 Quick Start

1. Set up your Notion integration

1. Visit https://www.notion.so/my-integrations.
2. Create a new integration.
3. Copy the API key.

2. Connect your Notion pages to the integration

To allow your integration to access Notion content, you need to explicitly share your pages or databases:

1. Navigate to the Notion page or database you want to access via the integration.
2. Click the "Share" button in the top - right corner.
3. In the "Add people, groups, or integrations" field, select your integration from the dropdown list.
4. Click "Invite".
5. Repeat for each page or database.

⚠️ Important Note

The integration can only access pages and databases that are explicitly shared with it. Parent pages do not automatically grant access to child pages.

3. Add to your AI assistant

You can add this MCP server to Claude Desktop, Cursor AI, or Claude.ai using one of the following configuration formats:

Command - line format

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON configuration format

{
  "name": "Notion",
  "command": {
    "args": [
      "@ramidecodes/mcp-server-notion@latest",
      "-y",
      "--api-key=your-notion-integration-key"
    ],
    "env": {},
    "executable": "npx"
  }
}

Replace your-notion-integration-key with the API key from Step 1.

Setup instructions

• Claude Desktop: Settings > Advanced > Model Context Protocol
• Cursor AI: Settings > AI > MCP Server
• Claude.ai: The corresponding configuration method mentioned in the documentation.

✨ Features

The following are the main features provided by the server:

1. Search: Allows AI models to query Notion content.
2. Database operations: Supports CRUD operations (Create, Read, Update, Delete) in Notion databases.
3. Page management: Includes functions for creating, editing, and deleting pages.
4. Block processing: Handles various content blocks in Notion pages, such as text, images, etc.

🔧 Troubleshooting

Common issues

1. API errors: Check if the API key is correctly configured and ensure that your integration has appropriate permissions.
2. Connection issues: Ensure that your network connection is normal and that the Notion service is available.
3. Error messages: Check the detailed error messages for more debugging information.

Solutions

1. Regenerate the key: If you encounter authentication issues, you can try regenerating the API key.
2. Check permissions: Ensure that your integration has the appropriate permissions to access the required resources.
3. Update dependencies: Ensure that all relevant dependencies are updated to the latest version.

💻 Additional Features

• Supports a variety of Notion operations, including searching, creating, and managing content.
• A powerful error - handling mechanism that provides detailed error messages.
• Environment variable configuration to simplify the setup process.

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.