MCP Server for AI-Notion Integration

by itsiiromiuy

334 downloads
Not rated
GitHub

Description

# MCP Server for AI-Notion Integration A Model Context Protocol (MCP) server that integrates with Notion databases to store AI question/answer pairs. This server provides tools for AI assistants to save information to your Notion workspace. ## Features - **Notion Database…

About

# MCP Server for AI-Notion Integration A Model Context Protocol (MCP) server that integrates with Notion databases to store AI question/answer pairs. This server provides tools for AI assistants to save information to your Notion workspace. ## Features - **Notion Database Integration**: Create and update entries in a…

Details

Author
itsiiromiuy
Downloads
334
Categories
Knowledge Base

- Integrates with Notion databases to track AI conversations
- Tools to create and update entries in a Notion database
- Script to automatically set up a properly structured database
- Supports searching and retrieving existing database entries
- Built with ES Module (ESM) compatibility for modern Node.js

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Server for AI-Notion Integration
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure a .env file with NOTION_API_TOKEN, NOTION_DATABASE_ID, and optionally NOTION_PARENT_PAGE_ID. Run npm start to start the server. AI assistants can then use the provided tools—notion_ai_save_entry and notion_query_database—to store and query Q&A entries.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp server for ai-notion integration": {
            "notion-mcp-server-itsiiromiuy": {
                "command": "node",
                "args": [
                    "dist/setup-database.js"
                ]
            }
        }
    }
}

McpServers

{
    "notion-mcp-server-itsiiromiuy": {
        "command": "node",
        "args": [
            "dist/setup-database.js"
        ]
    }
}

MCP Server for AI-Notion Integration

A Model Context Protocol (MCP) server that integrates with Notion databases to store AI question/answer pairs. This server provides tools for AI assistants to save information to your Notion workspace.

Features

- Notion Database Integration: Create and update entries in a Notion database for tracking AI conversations
- Database Setup: Tools to create a properly structured Notion database with the right properties
- Query Support: Search and retrieve entries from your database
- ESM Compatibility: Built with ES Module support for modern Node.js applications

Prerequisites

- Node.js 18 or higher
- A Notion account with an integration token
- A Notion database with appropriate properties (or use the setup script to create one)

Setup

1. Clone the repository
2. Install dependencies:

   npm install

3. Create a .env file with the following variables:
   NOTION_API_TOKEN=your_notion_integration_token
NOTION_DATABASE_ID=your_notion_database_id
NOTION_PARENT_PAGE_ID=your_notion_page_id (only needed for database setup)

Notion Integration Setup

1. Go to Notion Integrations and create a new integration
2. Give your integration a name (e.g., "AI QA Tracker") and select the appropriate capabilities (read & write)
3. Copy the "Internal Integration Token" and paste it into your .env file
4. Share your Notion database with your integration

Database Setup

To create a new database structure for tracking AI questions/answers:

npm run build
node dist/setup-database.js

This will create a new database with all the required properties and fields.

Usage

Starting the server:

npm start

Running tests:

To test your Notion connection:

npm test

Tools Provided by the MCP Server

This server provides the following tools to AI assistants:

1. notion_ai_save_entry: Save an AI/LLM-related question and answer to your Notion database
2. notion_query_database: Query your Notion database for existing entries

Development

Building the project:

npm run build

Running in development mode:

npm run dev

License

ISC

Acknowledgements

- Notion API
- Model Context Protocol

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.