Notion

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.

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

- 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

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

- Node.js (v16 or higher)
- Notion API key
- MCP-compatible client (e.g., Claude Desktop)

git clone https://github.com/v-3/notion-server.git cd notion-server

# 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

- Update your Claude Desktop configuration (claude_desktop_config.json):

{ "mcpServers": { "notion": { "command": "node", "args": ["/absolute/path/to/notion-server/build/index.js"], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }

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

// Create database { parentPageId: string, title: string, properties: object } // Query database { databaseId: string, filter?: object, sort?: object }

- VisitNotion Integrations
- Click "New integration"
- Configure permissions:

const result = await notion.create_page({ parentPageId: "page_id", title: "My Page", content: "# Welcome\nThis is a test page." });

const result = await notion.query_database({ databaseId: "db_id", filter: { property: "Status", select: { equals: "In Progress" } } });

This project is licensed under the MIT License - see theLICENSEfile for details.

This project has been significantly improved bysweir1/notion-server, who has made following updates:

git clone https://github.com/sweir1/notion-server.git

A universal remote MCP server that connects to popular productivity tools such as Notion, Monday, AirTable, and many more.