Skip to main content
Glama
itsiiromiuy

AI-Notion Integration MCP Server

by itsiiromiuy

Notion MCP Server

npm version License: MIT

AI-powered knowledge management with Notion integration and spaced repetition learning system.

✨ Features

  • πŸ“ Auto-save conversations - Save AI Q&A to Notion with intelligent categorization

  • πŸ” Advanced search - Query by date, category, tags, and full-text search

  • 🧠 Spaced repetition - Science-based review scheduling (1/2/4/7/15 days)

  • πŸ“Š Progress tracking - Track mastery levels (⭐-⭐⭐⭐⭐⭐) and review counts

πŸ“¦ Installation

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

Option 2: From Source

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

πŸš€ Quick Start

1. Create Notion Integration

  1. Go to Notion Integrations and create a new integration

Notion Integration Setup

  1. Give your integration a name (e.g., "AI Learning Tracker") and select the appropriate capabilities (read & write)

  2. Copy the "Internal Integration Token" and paste it into your .env file

Notion Integration Token

  1. Share your Notion page with the integration

2. Configure Environment

Create a .env file:

NOTION_API_TOKEN=ntn_your_token_here NOTION_PARENT_PAGE_ID=your_page_id_here NOTION_DATABASE_ID=your_database_id_here # Optional

3. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "notion-mcp-server": { "command": "node", "args": ["/path/to/notion-mcp-server/dist/index.js"], "env": { "NOTION_API_TOKEN": "ntn_your_token", "NOTION_PARENT_PAGE_ID": "your_page_id", "NOTION_DATABASE_ID": "your_database_id" } } } }

4. Restart Claude Desktop

You're ready to use it!

πŸ› οΈ Available Tools

Tool

Description

notion_setup_database

Create pre-configured database with spaced repetition fields

notion_ai_save_entry

Save Q&A with auto-categorization and tags

notion_query_database

Search with filters (date/category/tags)

notion_check_reviews

Check overdue and upcoming reviews

notion_update_mastery

Update mastery level and schedule next review

πŸ“ Project Structure

notion-mcp-server/ β”œβ”€β”€ src/ β”‚ β”œβ”€β”€ index.ts # Main MCP server β”‚ β”œβ”€β”€ config.ts # Configuration β”‚ └── types.ts # TypeScript types β”œβ”€β”€ docs/ β”‚ └── images/ # Documentation images β”œβ”€β”€ QUICKSTART.md # Detailed setup guide β”œβ”€β”€ DEMO_SCENARIOS.md # Usage examples β”œβ”€β”€ LICENSE # MIT License └── package.json # Dependencies

πŸ“š Documentation

πŸ”§ Requirements

  • Node.js 18+

  • npm 9+

  • Notion account with workspace

  • Claude Desktop (latest version)

πŸ› Troubleshooting

Connection failed?

  1. Check .env file has correct token

  2. Run npm run build to generate dist/index.js

  3. Verify path in Claude config

  4. Restart Claude Desktop

Database permission denied?

  1. Go to your Notion page

  2. Click "..." β†’ "Add connections"

  3. Select your integration

  4. Restart Claude Desktop

πŸ“„ License

MIT - see LICENSE


New to this project? Start with QUICKSTART.md πŸš€

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/itsiiromiuy/notion-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server