Notion MCP 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
- Clone the repository:
- Install dependencies:
- Set up your environment:
- Build the server:
🔧 Configuration
Claude Desktop Setup
- Update your Claude Desktop configuration (
claude_desktop_config.json
):
- Restart Claude Desktop to apply changes
🛠️ Available Tools
Page Operations
Database Operations
🔐 Setting Up Notion Access
Creating an Integration
- Visit Notion Integrations
- Click "New integration"
- Configure permissions:
- Content: Read, Update, Insert
- Comments: Read, Create
- User Information: Read
Connecting Pages
- Open your Notion page
- Click "..." menu → "Connections"
- Add your integration
- Repeat for other pages as needed
📝 Usage Examples
Creating a Page
Querying a Database
🤝 Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Submit a Pull Request
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
This project has been significantly improved by sweir1/notion-server, who has made following updates:
- Enhanced markdown support with more block types
- Comprehensive database operations
- Improved error handling and debugging
- Better property handling for database items
- Cleaner page output formatting
To use sweir1's version, you can clone their repository:
This server cannot be installed
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.
ページやデータベースを検索、読み取り、作成、更新するための標準化されたツールを通じて、言語モデルが Notion ワークスペースと対話できるようにします。
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables interaction with Notion through the Notion API by exposing it as tools for LLMs, allowing operations like reading, creating, updating, and deleting Notion pages seamlessly via natural language.Last updated -622
- -securityAlicense-qualityA Model Context Protocol server that provides a standardized interface for AI models to access, query, and modify content in Notion workspaces.Last updated -2734MIT License
- AsecurityAlicenseAqualityEnables AI agents to interact with Notion workspaces through the Notion API. Supports reading, writing, commenting, and managing Notion pages and databases with optimized token consumption for AI agents.Last updated -1946,432MIT License
- -securityFlicense-qualityEnables interaction with Notion workspaces through the Notion API. Provides tools to search, read, create, and update Notion pages and databases with real-time synchronization.Last updated -273