Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (systemprompt-mcp-notion) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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:

Systemprompt API Key (Free)
- Sign up at systemprompt.io/console
- Create a new API key in your dashboard
Notion Account and Workspace
- Active Notion account
- Workspace with content you want to access
Notion Integration
- Create at notion.so/my-integrations
- Required capabilities:
  - Read/Update/Insert content
  - Database management
  - Comment management
  - Search functionality
MCP-Compatible Client
- Systemprompt MCP Client
- Any other MCP-compatible client

Quick Start

Installation
```
npm install systemprompt-mcp-notion
```

Configuration Create a .env file:

SYSTEMPROMPT_API_KEY=your_systemprompt_api_key
NOTION_API_KEY=your_notion_integration_token

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

Clone the repository:

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

Install dependencies:
```
npm install
```

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