What is Notion

systemprompt-mcp-notion is a Model Context Protocol (MCP) server that integrates Notion into AI workflows, enabling AI agents to interact with Notion pages, databases, and comments seamlessly.

Use cases

Use cases include automating content management in Notion, integrating Notion data into AI applications, and enhancing productivity by allowing AI agents to interact with Notion seamlessly.

How to use

To use systemprompt-mcp-notion, install it via npm or Smithery, configure your API keys in a .env file, and set up your MCP configuration to include the Notion server. Ensure you have a Notion account and integration set up with the necessary permissions.

Key features

Key features include comprehensive content management capabilities such as creating and updating pages with rich text formatting, searching across the Notion workspace, developer-friendly tools with extensive test coverage, TypeScript support, and detailed logging.

Where to use

systemprompt-mcp-notion

Website | Documentation

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 and databases through a standardized protocol. This server supports and requires MCP Sampling, which is required to the MCP to create and update Notion pages.

A compatible MCP client is available here.

Server Capabilities

const serverCapabilities: { capabilities: ServerCapabilities } = {
  capabilities: {
    resources: {
      listChanged: true,
    },
    tools: {},
    prompts: {
      listChanged: true,
    },
    sampling: {},
  },
};

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

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
     • Search functionality

4. MCP-Compatible Client

   • Systemprompt MCP Client
   • Any other MCP-compatible client

Quick Start

1. Installation

   Installing via Smithery

   To install systemprompt-mcp-notion for Claude Desktop automatically via Smithery:

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

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

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