v-3/notion-server

A Model Context Protocol (MCP) server that provides seamless integration with Notion. This server enables Language Models to interact with your Notion workspace through standardized tools for searching, reading, creating, and updating pages and databases.
## 🌟 Key Features
### Page Operations
🔍 Search through your Notion workspace
📝 Create new pages with rich markdown content
📖 Read page content with clean formatting
🔄 Update existing pages
💬 Add and retrieve comments
🧱 Block-level operations (update, delete)
### Enhanced Markdown Support
Multiple heading levels (H1-H3)
Code blocks with language support
Interactive todo items with checkbox states
Blockquotes with multi-line support
Horizontal dividers
Images with captions
Nested bullet points
### Database Operations
Create and manage databases
Add and update database items
Query with filters and sorting
Support for various property types:
Title, Rich text, Number
Select, Multi-select
Date, Checkbox
And more!
## 🚀 Getting Started
### Prerequisites
Node.js (v16 or higher)
Notion API key
MCP-compatible client (e.g., Claude Desktop)
### Installation
1. Clone the repository:
bash
git clone https://github.com/v-3/notion-server.git
cd notion-server
2. Install dependencies:
bash
npm install
3. Set up your environment:
bash
# Create .env file
echo "NOTION_API_KEY=your_notion_api_key_here" > .env
# Or export directly
export NOTION_API_KEY=your_notion_api_key_here
4. Build the server:
bash
npm run build
## 🔧 Configuration
### Claude Desktop Setup
1. Update your Claude Desktop configuration (claude_desktop_config.json):
json
"mcpServers": {
"notion": {
"command": "node",
"args": ["/absolute/path/to/notion-server/build/index.js"],
"env": {
"NOTION_API_KEY": "your_notion_api_key_here"
2. Restart Claude Desktop to apply changes
## 🛠️ Available Tools
### Page Operations
typescript
// Search pages
query: string // Search query
// Read page
pageId: string // ID of the page to read
// Create page
title?: string, // Page title
content?: string, // Page content in markdown
parentPageId: string // Parent page ID
properties?: object // For database items
// Update page
pageId: string, // Page ID to update
content: string, // New content
type?: string // Content type
### Database Operations
typescript
// Create database
parentPageId: string,
title: string,
properties: object
// Query database
databaseId: string,
filter?: object,
sort?: object
## 🔐 Setting Up Notion Access
### Creating an Integration
1. Visit Notion Integrations
2. Click "New integration"
3. Configure permissions:
Content: Read, Update, Insert
Comments: Read, Create
User Information: Read
### Connecting Pages
1. Open your Notion page
2. Click "..." menu → "Connections"
3. Add your integration
4. Repeat for other pages as needed
## 📝 Usage Examples
### Creating a Page
typescript