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)

2. Sign up at systemprompt.io/console

3. Create a new API key in your dashboard

4. Notion Account and Workspace

5. Active Notion account

6. Workspace with content you want to access

7. Notion Integration

8. Create at notion.so/my-integrations

9. Required capabilities:

   • Read/Update/Insert content
   • Database management
   • Search functionality

10. MCP-Compatible Client

11. Systemprompt MCP Client
12. Any other MCP-compatible client

Quick Start

1. Installation

### Installing via Smithery

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

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

bash npm install systemprompt-mcp-notion

1. Configuration Create a .env file:

env SYSTEMPROMPT_API_KEY=your_systemprompt_api_key NOTION_API_KEY=your_notion_integration_token

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

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:

json { "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:

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

1. Install dependencies:

bash npm install

1. Set up environment: bash 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