MCP Server for AI-Notion Integration

by itsiiromiuy

334 downloads Not rated yet
GitHub

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…

Explore

- 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

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

- 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)

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

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.

To test your Notion connection:

npm test
npm run dev

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

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"
        ]
    }
}

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.