Skip to main content
Glama
itsyuimorii

AI-Notion Integration MCP Server

by itsyuimorii

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 šŸš€

Related MCP Connectors