{"id":26937546,"url":"https://github.com/v-3/notion-server","last_synced_at":"2025-04-02T13:15:40.787Z","repository":{"id":268357117,"uuid":"904087475","full_name":"v-3/notion-server","owner":"v-3","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-26T02:16:58.000Z","size":5902,"stargazers_count":6,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-26T03:22:04.639Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/v-3.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-16T08:27:01.000Z","updated_at":"2025-01-26T02:17:03.000Z","dependencies_parsed_at":"2024-12-16T09:31:46.370Z","dependency_job_id":"39b907a0-99e2-4ebf-bd61-9b09a8805e35","html_url":"https://github.com/v-3/notion-server","commit_stats":null,"previous_names":["v-3/notion-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v-3%2Fnotion-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v-3%2Fnotion-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v-3%2Fnotion-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v-3%2Fnotion-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/v-3","download_url":"https://codeload.github.com/v-3/notion-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246819779,"owners_count":20839095,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-02T13:15:20.583Z","updated_at":"2025-04-02T13:15:40.777Z","avatar_url":"https://github.com/v-3.png","language":"JavaScript","readme":"# Notion MCP Server\n\nA 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.\n\n## 🌟 Key Features\n\n### Page Operations\n- 🔍 Search through your Notion workspace\n- 📝 Create new pages with rich markdown content\n- 📖 Read page content with clean formatting\n- 🔄 Update existing pages\n- 💬 Add and retrieve comments\n- 🧱 Block-level operations (update, delete)\n\n### Enhanced Markdown Support\n- Multiple heading levels (H1-H3)\n- Code blocks with language support\n- Interactive todo items with checkbox states\n- Blockquotes with multi-line support\n- Horizontal dividers\n- Images with captions\n- Nested bullet points\n\n### Database Operations\n- Create and manage databases\n- Add and update database items\n- Query with filters and sorting\n- Support for various property types:\n  - Title, Rich text, Number\n  - Select, Multi-select\n  - Date, Checkbox\n  - And more!\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js (v16 or higher)\n- Notion API key\n- MCP-compatible client (e.g., Claude Desktop)\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/v-3/notion-server.git\ncd notion-server\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Set up your environment:\n```bash\n# Create .env file\necho \"NOTION_API_KEY=your_notion_api_key_here\" \u003e .env\n\n# Or export directly\nexport NOTION_API_KEY=your_notion_api_key_here\n```\n\n4. Build the server:\n```bash\nnpm run build\n```\n\n## 🔧 Configuration\n\n### Claude Desktop Setup\n\n1. Update your Claude Desktop configuration (`claude_desktop_config.json`):\n```json\n{\n    \"mcpServers\": {\n        \"notion\": {\n            \"command\": \"node\",\n            \"args\": [\"/absolute/path/to/notion-server/build/index.js\"],\n            \"env\": {\n                \"NOTION_API_KEY\": \"your_notion_api_key_here\"\n            }\n        }\n    }\n}\n```\n\n2. Restart Claude Desktop to apply changes\n\n## 🛠️ Available Tools\n\n### Page Operations\n```typescript\n// Search pages\n{\n    query: string // Search query\n}\n\n// Read page\n{\n    pageId: string // ID of the page to read\n}\n\n// Create page\n{\n    title?: string,      // Page title\n    content?: string,    // Page content in markdown\n    parentPageId: string // Parent page ID\n    properties?: object  // For database items\n}\n\n// Update page\n{\n    pageId: string,   // Page ID to update\n    content: string,  // New content\n    type?: string    // Content type\n}\n```\n\n### Database Operations\n```typescript\n// Create database\n{\n    parentPageId: string,\n    title: string,\n    properties: object\n}\n\n// Query database\n{\n    databaseId: string,\n    filter?: object,\n    sort?: object\n}\n```\n\n## 🔐 Setting Up Notion Access\n\n### Creating an Integration\n1. Visit [Notion Integrations](https://www.notion.so/my-integrations)\n2. Click \"New integration\"\n3. Configure permissions:\n   - Content: Read, Update, Insert\n   - Comments: Read, Create\n   - User Information: Read\n\n### Connecting Pages\n1. Open your Notion page\n2. Click \"...\" menu → \"Connections\"\n3. Add your integration\n4. Repeat for other pages as needed\n\n## 📝 Usage Examples\n\n### Creating a Page\n```typescript\nconst result = await notion.create_page({\n  parentPageId: \"page_id\",\n  title: \"My Page\",\n  content: \"# Welcome\\nThis is a test page.\"\n});\n```\n\n### Querying a Database\n```typescript\nconst result = await notion.query_database({\n  databaseId: \"db_id\",\n  filter: {\n    property: \"Status\",\n    select: {\n      equals: \"In Progress\"\n    }\n  }\n});\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please:\n1. Fork the repository\n2. Create a feature branch\n3. Submit a Pull Request\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\nThis project has been significantly improved by [sweir1/notion-server](https://github.com/sweir1/notion-server), who has made following updates:\n- Enhanced markdown support with more block types\n- Comprehensive database operations\n- Improved error handling and debugging\n- Better property handling for database items\n- Cleaner page output formatting\n\nTo use sweir1's version, you can clone their repository:\n```bash\ngit clone https://github.com/sweir1/notion-server.git\n```","funding_links":[],"categories":["Community Servers","MCP 服务器精选列表","Other Tools and Integrations","Note-Taking and Knowledge Bases","Mcp Server Directories \u0026 Lists","📦 Other","Table of Contents","🗂️ Extensions by Category"],"sub_categories":["🛠️ 效率工具与集成 (Office, Project Management, Notes, etc.)","How to Submit","Knowledge and Memory","⚡ Productivity"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv-3%2Fnotion-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fv-3%2Fnotion-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv-3%2Fnotion-server/lists"}