systemprompt-mcp-notion

Website | Documentation | Blog

SystemPrompt MCP Notion Server

A high-performance Model Context Protocol (MCP) server that seamlessly integrates Notion into your AI workflows. This server enables AI agents to interact with Notion pages, databases, and comments through a standardized protocol.

Key Features

• 🔄 Real-time Synchronization

  • Bi-directional sync between AI agents and Notion
  • Instant updates and notifications
  • Conflict resolution handling

• 📝 Comprehensive Content Management

  • Create and update pages with rich text formatting
  • Manage databases with complex queries
  • Handle comments and discussions
  • Search across your Notion workspace

• 🔒 Enterprise-Grade Security

  • Secure API key management
  • Granular permission controls
  • Rate limiting and request validation

• 🛠 Developer-Friendly

  • Extensive test coverage with Jest
  • TypeScript support
  • Comprehensive error handling
  • Detailed logging and debugging tools

Prerequisites

Before using this server, you'll need:

1. Systemprompt API Key (Free)

   • Sign up at systemprompt.io/console
   • Create a new API key in your dashboard

2. Notion Account and Workspace

   • Active Notion account
   • Workspace with content you want to access

3. Notion Integration

   • Create at notion.so/my-integrations
   • Required capabilities:
     • Read/Update/Insert content
     • Database management
     • Comment management
     • Search functionality

4. MCP-Compatible Client

   • Systemprompt MCP Client
   • Claude Desktop
   • Any other MCP-compatible client

Quick Start

1. Installation

   npm install systemprompt-mcp-notion

2. Configuration Create a .env file:

   SYSTEMPROMPT_API_KEY=your_systemprompt_api_key
   NOTION_API_KEY=your_notion_integration_token

3. MCP Configuration Add the following to your MCP configuration JSON:

   {
     "mcpServers": {
       "notion": {
         "command": "npx",
         "args": ["systemprompt-mcp-notion"],
         "env": {
           "SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
           "NOTION_API_KEY": "your_notion_integration_token"
         }
       }
     }
   }

   Alternatively, if you've installed the package locally:

   {
     "mcpServers": {
       "notion": {
         "command": "node",
         "args": ["./node_modules/systemprompt-mcp-notion/build/index.js"],
         "env": {
           "SYSTEMPROMPT_API_KEY": "your_systemprompt_api_key",
           "NOTION_API_KEY": "your_notion_integration_token"
         }
       }
     }
   }

4. Basic Usage

   import { NotionMCPServer } from "systemprompt-mcp-notion";
   
   const server = new NotionMCPServer();
   server.start();

Development

Setup

1. Clone the repository:

   git clone https://github.com/systemprompt-io/systemprompt-mcp-notion.git
   cd systemprompt-mcp-notion

2. Install dependencies:

   npm install

3. Set up environment:

   cp .env.example .env
   # Edit .env with your API keys

Testing

We maintain high test coverage using Jest:

# Run all tests
npm test

# Watch mode for development
npm run test:watch

# Generate coverage report
npm run test:coverage

# Test Notion API connection
npm run test:notion