notion

notion-mcp-server is a Model Context Protocol (MCP) server integrated with Notion database. It provides tools for AI assistants to save question-answer pairs to Notion workspace.

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

View docs

Command

claude mcp add --transport stdio itsiiromiuy-notion-mcp-server node /path/to/notion-mcp-server/dist/index.js \
  --env NOTION_API_TOKEN="your_notion_integration_token" \
  --env NOTION_DATABASE_ID="optional_database_id" \
  --env NOTION_PARENT_PAGE_ID="your_parent_page_id"

How to use

Notion MCP Server provides an AI-assisted Notion integration with a built-in spaced repetition system. It auto-saves conversations, enables advanced search by date, category, and tags, and manages review scheduling to reinforce learning. You can configure the server to run under your preferred runtime (Node.js) and connect it to Claude Desktop or other clients via a configured MCP endpoint. The key tools exposed by this server allow you to create a Notion database pre-configured for spaced repetition, save Q&A pairs with automatic categorization, query entries with filters, check due reviews, and update mastery levels along with next review dates.

How to install

Prerequisites:

Node.js 18+ and npm 9+ installed on your system
Notion account with a workspace and a Notion Integration token with read/write access
Access to the host where you will run the MCP server

Install options:

Install globally via NPM (recommended):

npm install -g @itsyuimorii/notion-mcp-server

Install from source:

git clone https://github.com/itsyuimorii/notion-mcp-server.git
cd notion-mcp-server
npm install
npm run build

After installation, start the server (example):

node dist/index.js --port 3000

Configure your MCP client to point to the server endpoint as needed (e.g., Claude Desktop integration).

Additional notes

Tips and common issues:

Ensure your Notion API token and IDs are correct in the environment (.env or runtime env) before starting the server.
If the server cannot connect, regenerate or verify the Notion integration permissions and re-share the page with the integration.
Run npm run build to generate dist/index.js before starting the server if using the build workflow.
When using Claude Desktop, ensure the path in the Claude config points to the built dist/index.js and that environment variables are provided in that config.
The database ID is optional but recommended for proper save and query operations; if omitted, operations may default to page-level storage.
Check Node.js version and npm version compatibility with the project requirements.

Related MCP Servers

mcp-for-beginners

14.5k

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable, and secure AI workflows from session setup to service orchestration.

mcp-router

1.8k

A Unified MCP Server Management App (MCP Manager).

rust -sdk

156

A high-performance, asynchronous toolkit for building MCP servers and clients in Rust.

furi

CLI & API for MCP management

rod

Model Context Protocol Server of Rod

unity-editor

An MCP server and client for LLMs to interact with Unity Projects