Skip to content
Back to search

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…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/v-3--notion-server/badge.svg)](/listings/v-3--notion-server)

HTML

<a href="/listings/v-3--notion-server"><img src="/api/listings/v-3--notion-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

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

Installation

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Set up your environment:

# 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:

npm run build

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 199 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Notion MCP Server
  2. 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.
  3. ## 🌟 Key Features
  4. ### Page Operations
  5. - 🔍 Search through your Notion workspace
  6. - 📝 Create new pages with rich markdown content
  7. - 📖 Read page content with clean formatting
  8. - 🔄 Update existing pages
  9. - 💬 Add and retrieve comments
  10. - 🧱 Block-level operations (update, delete)
  11. ### Enhanced Markdown Support
  12. - Multiple heading levels (H1-H3)
  13. - Code blocks with language support
  14. - Interactive todo items with checkbox states
  15. - Blockquotes with multi-line support
  16. - Horizontal dividers
  17. - Images with captions
  18. - Nested bullet points
  19. ### Database Operations
  20. - Create and manage databases
  21. - Add and update database items
  22. - Query with filters and sorting
  23. - Support for various property types:
  24. - Title, Rich text, Number
  25. - Select, Multi-select
  26. - Date, Checkbox
  27. - And more!
  28. ## 🚀 Getting Started
  29. ### Prerequisites
  30. - Node.js (v16 or higher)
  31. - Notion API key
  32. - MCP-compatible client (e.g., Claude Desktop)
  33. ### Installation
  34. 1. Clone the repository:
  35. ```bash
  36. git clone https://github.com/v-3/notion-server.git
  37. cd notion-server
  38. ```
  39. 2. Install dependencies:
  40. ```bash
  41. npm install
  42. ```
  43. 3. Set up your environment:
  44. ```bash
  45. # Create .env file
  46. echo "NOTION_API_KEY=your_notion_api_key_here" > .env
  47. # Or export directly
  48. export NOTION_API_KEY=your_notion_api_key_here
  49. ```
  50. 4. Build the server:
  51. ```bash
  52. npm run build
  53. ```
  54. ## 🔧 Configuration
  55. ### Claude Desktop Setup
  56. 1. Update your Claude Desktop configuration (`claude_desktop_config.json`):
  57. ```json
  58. {
  59. "mcpServers": {
  60. "notion": {
  61. "command": "node",
  62. "args": ["/absolute/path/to/notion-server/build/index.js"],
  63. "env": {
  64. "NOTION_API_KEY": "your_notion_api_key_here"
  65. }
  66. }
  67. }
  68. }
  69. ```
  70. 2. Restart Claude Desktop to apply changes
  71. ## 🛠️ Available Tools
  72. ### Page Operations
  73. ```typescript
  74. // Search pages
  75. {
  76. query: string // Search query
  77. }
  78. // Read page
  79. {
  80. pageId: string // ID of the page to read
  81. }
  82. // Create page
  83. {
  84. title?: string, // Page title
  85. content?: string, // Page content in markdown
  86. parentPageId: string // Parent page ID
  87. properties?: object // For database items
  88. }
  89. // Update page
  90. {
  91. pageId: string, // Page ID to update
  92. content: string, // New content
  93. type?: string // Content type
  94. }
  95. ```
  96. ### Database Operations
  97. ```typescript
  98. // Create database
  99. {
  100. parentPageId: string,
  101. title: string,
  102. properties: object
  103. }
  104. // Query database
  105. {
  106. databaseId: string,
  107. filter?: object,
  108. sort?: object
  109. }
  110. ```
  111. ## 🔐 Setting Up Notion Access
  112. ### Creating an Integration
  113. 1. Visit [Notion Integrations](https://www.notion.so/my-integrations)
  114. 2. Click "New integration"
  115. 3. Configure permissions:
  116. - Content: Read, Update, Insert
  117. - Comments: Read, Create
  118. - User Information: Read
  119. ### Connecting Pages
  120. 1. Open your Notion page
  121. 2. Click "..." menu → "Connections"
  122. 3. Add your integration
  123. 4. Repeat for other pages as needed
  124. ## 📝 Usage Examples
  125. ### Creating a Page
  126. ```typescript
  127. const result = await notion.create_page({
  128. parentPageId: "page_id",
  129. title: "My Page",
  130. content: "# Welcome\nThis is a test page."
  131. });
  132. ```
  133. ### Querying a Database
  134. ```typescript
  135. const result = await notion.query_database({
  136. databaseId: "db_id",
  137. filter: {
  138. property: "Status",
  139. select: {
  140. equals: "In Progress"
  141. }
  142. }
  143. });
  144. ```
  145. ## 🤝 Contributing
  146. Contributions are welcome! Please:
  147. 1. Fork the repository
  148. 2. Create a feature branch
  149. 3. Submit a Pull Request
  150. ## 📜 License
  151. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  152. ## 🙏 Acknowledgments
  153. This project has been significantly improved by [sweir1/notion-server](https://github.com/sweir1/notion-server), who has made following updates:
  154. - Enhanced markdown support with more block types
  155. - Comprehensive database operations
  156. - Improved error handling and debugging
  157. - Better property handling for database items
  158. - Cleaner page output formatting
  159. To use sweir1's version, you can clone their repository:
  160. ```bash
  161. git clone https://github.com/sweir1/notion-server.git
  162. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.