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

A compatible MCP client is available here. Complicated AI usage is managed by sampling and LLMs.

<a href="https://glama.ai/mcp/servers/xe6grtrr0k"><img width="380" height="200" src="https://glama.ai/mcp/servers/xe6grtrr0k/badge" alt="SystemPrompt Notion Server MCP server" /></a>

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: