Systemprompt MCP Notion

🚀 SystemPrompt MCP Notion Server

A high-performance Model Context Protocol (MCP) server that seamlessly integrates Notion into your AI workflow. This server enables AI agents to interact with Notion pages and databases through a standardized protocol. It supports and requires MCP sampling, which is essential for creating and updating Notion pages using MCP.

Compatible MCP clients are available here.

🚀 Quick Start

The SystemPrompt MCP Notion Server is a powerful tool that allows AI agents to interact with Notion pages and databases. To get started, make sure you have met the prerequisites and follow the development setup instructions.

✨ Features

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 within your Notion workspace.
• 🛠 Developer-Friendly
  • Fully tested with Jest.
  • Supports TypeScript.
  • Comes with detailed logging and debugging tools.

📦 Installation

Prerequisites

Before using this server, you need to:

1. System Prompt API Key (Free)

• Sign up at systemprompt.io/console.
• Create a new API key on your dashboard.

2. Notion Account and Workspace

• An active Notion account.
• A workspace containing the content you want to access.

3. Notion Integration

• Create it at notion.so/my-integrations.
• Required capabilities:
  • Read/Update/Insert content.
  • Database management.
  • Search functionality.

4. MCP Compatible Client

• Use the compatible client here.

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 the environment:

cp .env.example .env
# Edit the API keys in the .env file

Testing

We use Jest to maintain high test coverage:

# 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