akirapapa -notion

This MCP server exposes a Notion integration for Claude so you can manage Notion data through natural language prompts. The server provides a suite of Notion API tools that let you create, fetch, update, and delete blocks, pages, databases, and database items, as well as query and retrieve database information. Use these tools to build workflows such as composing pages, organizing content in databases, or updating page properties directly from chat prompts. Each tool maps to a Notion API operation (for example, notion_create_database to create a new database or notion_update_page_properties to modify a page’s properties). To use them, authenticate with your Notion integration token via the provided environment variable NOTION_API_TOKEN, and run the MCP server. Once running, your Claude prompts can invoke the tools to interact with your Notion workspace in a structured way.

Prerequisites:

• Node.js (and npm) installed on your system
• Access to a Notion integration with a generated Internal Integration Token

Installation steps:

1. Clone or download the MCP Notion server repository.
2. Install dependencies: npm install
3. Build the server if a build step is required (for example, npm run build). If no build step exists, skip this step.
4. Prepare your run configuration by setting the Notion token in the environment or in your Claude Desktop config, as shown below.
5. Run the server: node path/to/your-built-file.js

Configuration example (Claude Desktop): { "mcpServers": { "notion": { "command": "node", "args": ["your-built-file-path"], "env": { "NOTION_API_TOKEN": "your-integration-token" } } } }

Notes:

• Replace your-built-file-path with the actual path to the server entry file.
• Ensure NOTION_API_TOKEN has correct permissions for the pages/databases you intend to access.

Tips and potential issues:

• Ensure the Notion integration token has the required permissions (read/update as needed) and is invited to the relevant workspace pages or databases.
• If you encounter authentication errors, double-check the NOTION_API_TOKEN value and that it is properly loaded into the environment.
• When using query_database or retrieve_database, you may need to provide optional filters, sorts, or pagination parameters depending on your data size.
• If the server fails to start, verify Node.js version compatibility and that all dependencies are correctly installed.
• For deployment, consider securing the token via a secrets manager and avoiding hard-coded tokens in code or config files.