{"_id":"@cloud9-labs/mcp-notion","name":"@cloud9-labs/mcp-notion","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@cloud9-labs/mcp-notion","version":"0.1.0","description":"MCP server for Notion API - manage databases, pages, blocks, and search across your workspace","type":"module","bin":{"mcp-notion":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc","dev":"tsc --watch","prepare":"npm run build"},"keywords":["mcp","notion","knowledge-base","wiki","ai","model-context-protocol"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/cloud9-labs/mcp-notion.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","zod":"^3.24.0"},"devDependencies":{"typescript":"^5.7.0"},"engines":{"node":">=20.0.0"},"gitHead":"003af5eac1310b6e5e13901734e7f424c2f8f353","types":"./dist/index.d.ts","_id":"@cloud9-labs/mcp-notion@0.1.0","bugs":{"url":"https://github.com/cloud9-labs/mcp-notion/issues"},"homepage":"https://github.com/cloud9-labs/mcp-notion#readme","_nodeVersion":"24.11.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-prrGG4QJKRzxyshg6HE9Ksm/T4RsfALcEqEdOZMx1KVTIvQbHmuNg/IsE0uu2FnXl7gzu/P3dM0nUXMQ88qOLw==","shasum":"cb33d46e0b2f10f13d6b0cd05a7ca6035369ae61","tarball":"https://registry.npmjs.org/@cloud9-labs/mcp-notion/-/mcp-notion-0.1.0.tgz","fileCount":24,"unpackedSize":75580,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF5gMH+lVRiOn4ruz4MfpE3hUZ96BUcY6Wen28O5jg8cAiEA3/jksrojbFYNJqzpoSwW7GQpr+tX+tnoD9qyDq10xJ0="}]},"_npmUser":{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"},"directories":{},"maintainers":[{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-notion_0.1.0_1770852269589_0.3902580667537512"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-11T23:24:29.524Z","0.1.0":"2026-02-11T23:24:29.749Z","modified":"2026-02-11T23:24:29.966Z"},"maintainers":[{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"}],"description":"MCP server for Notion API - manage databases, pages, blocks, and search across your workspace","homepage":"https://github.com/cloud9-labs/mcp-notion#readme","keywords":["mcp","notion","knowledge-base","wiki","ai","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/cloud9-labs/mcp-notion.git"},"bugs":{"url":"https://github.com/cloud9-labs/mcp-notion/issues"},"license":"MIT","readme":"# Notion MCP Server\n\nA Model Context Protocol (MCP) server that provides full access to the Notion API. Search, create, and manage databases, pages, blocks, and users directly from Claude, Cursor, or any MCP-compatible client.\n\n## Features\n\n- **Search** - Full-text search across all pages and databases\n- **Database Management** - Create databases, query with filters and sorts\n- **Page Management** - Create, read, update, and archive pages\n- **Block Management** - Read, append, and delete content blocks\n- **User Access** - List workspace members and get user details\n- **Built-in Rate Limiting** - Automatic throttling (3 req/s) with 429 retry\n\n## Available Tools (13)\n\n| Tool | Description |\n|------|-------------|\n| `notion_search` | Search across all pages and databases |\n| `notion_get_database` | Get database schema and details |\n| `notion_query_database` | Query database with filters and sorting |\n| `notion_create_database` | Create a new database in a page |\n| `notion_create_page` | Create a new page in a database or page |\n| `notion_get_page` | Get page properties and metadata |\n| `notion_update_page` | Update page properties or archive |\n| `notion_get_block` | Get a block by ID |\n| `notion_get_block_children` | Get child blocks of a page or block |\n| `notion_append_block_children` | Append content blocks to a page |\n| `notion_delete_block` | Delete (archive) a block |\n| `notion_list_users` | List all workspace users |\n| `notion_get_user` | Get user details by ID |\n\n## Quick Start\n\n```bash\nnpx @cloud9-labs/mcp-notion\n```\n\n## Prerequisites\n\n- Node.js >= 20.0.0\n- Notion Internal Integration token from [My Integrations](https://www.notion.so/my-integrations)\n\n### Setting Up Notion Integration\n\n1. Go to [notion.so/my-integrations](https://www.notion.so/my-integrations)\n2. Click \"New integration\"\n3. Give it a name and select a workspace\n4. Copy the Internal Integration Token\n5. Share target pages/databases with the integration\n\n## Installation\n\n### Via npx (Recommended)\n\nNo installation needed - configure your MCP client to use npx.\n\n### Via npm\n\n```bash\nnpm i -g @cloud9-labs/mcp-notion\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/cloud9-labs/mcp-notion.git\ncd mcp-notion\nnpm ci\nnpm run build\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"notion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cloud9-labs/mcp-notion\"],\n      \"env\": {\n        \"NOTION_API_KEY\": \"ntn_your_integration_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"notion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cloud9-labs/mcp-notion\"],\n      \"env\": {\n        \"NOTION_API_KEY\": \"ntn_your_integration_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\n- \"Search for all pages about marketing\"\n- \"Query the Tasks database for items assigned to me\"\n- \"Create a new page in database abc123 with title Meeting Notes\"\n- \"Add a paragraph block to page xyz789\"\n- \"List all users in the workspace\"\n- \"Get the schema of database def456\"\n\n## Building an AI Sales Automation System?\n\nThis MCP server is part of an open-source toolkit for AI-powered sales automation. We are building MCP servers that connect your entire sales stack.\n\nFollow our progress and get updates:\n\n- **X (Twitter)**: [@cloud9_ai_labs](https://x.com/cloud9_ai_labs)\n- **GitHub**: [cloud9-labs](https://github.com/cloud9-labs)\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-0989a951a73f203ebc26e700056012b8"}