📌Overview

Purpose: To provide a high-performance Model Context Protocol (MCP) server that integrates Notion into AI workflows for seamless interaction with Notion pages and databases.

Overview: The SystemPrompt MCP Notion Server facilitates communication between AI agents and Notion's data through a standardized protocol, enabling functionalities like creating, updating, and searching content within Notion.

Key Features:

• 📝 Comprehensive Content Management:
  Supports creating and updating pages with rich text formatting and searching across the Notion workspace.

• 🛠 Developer-Friendly:
  Includes extensive test coverage utilizing Jest, TypeScript support, comprehensive error handling, and detailed logging for effective debugging.

---

systemprompt-mcp-notion

Overview

SystemPrompt MCP Notion Server is a high-performance Model Context Protocol (MCP) server that integrates Notion into AI workflows, allowing AI agents to interact with Notion pages and databases.

Key Features

• Comprehensive Content Management

  • Create and update pages with rich text formatting
  • Search across your Notion workspace

• Developer-Friendly

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

Prerequisites

To use this server, you need:

1. SystemPrompt API Key

   • Sign up at systemprompt.io/console and create a new API key.

2. Notion Account and Workspace

   • An active Notion account with accessible content.

3. Notion Integration

   • Create an integration at notion.so/my-integrations with permissions to read, update, and search content.

4. MCP-Compatible Client

   • Use the SystemPrompt MCP Client or any other MCP-compatible client.

Quick Start

1. Installation

   To install via Smithery, run:

   npx -y @smithery/cli install systemprompt-mcp-notion --client claude
   

   Alternatively, you can install using npm:

   npm install systemprompt-mcp-notion
   

2. Configuration

   Create a .env file with the following variables:

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

   If installed locally, use:

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

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

Run tests and generate coverage reports using Jest:

# Run all tests
npm test

# Watch mode for continuous testing
npm run test:watch

# Generate coverage report
npm run test:coverage

# Test Notion API connection
npm run test:notion