remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows AI agents to interact with Notion pages and databases, enabling creation and updating of pages with rich text formatting and searching across the Notion workspace

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:

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
  - Search functionality
MCP-Compatible Client
- Systemprompt MCP Client
- Any other MCP-compatible client

Quick Start

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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

A high-performance MCP server that integrates Notion into AI workflows, enabling interaction with Notion pages, databases, and comments through a standardized protocol.

SystemPrompt MCP Notion Server

Related Resources

Reddit Discussion about this server