{"_id":"@iflow-mcp/mcp-server-notion","name":"@iflow-mcp/mcp-server-notion","dist-tags":{"latest":"1.0.6"},"versions":{"1.0.6":{"name":"@iflow-mcp/mcp-server-notion","version":"1.0.6","description":"A Model Context Protocol (MCP) server that exposes the official Notion SDK","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"mcp-server-notion":"dist/bin.js"},"scripts":{"build":"tsc","start":"node dist/bin.js","dev":"ts-node-dev --respawn --transpile-only src/bin.ts","lint":"eslint --ext .ts src/","test":"echo \"Error: no test specified\" && exit 1","prepare":"npm run build","prepublishOnly":"npm run lint && npm run build"},"keywords":["mcp","notion","model-context-protocol","llm","mcp-server","cursor","modelcontextprotocol","notion-api","notion-sdk-js"],"author":{"name":"Ramiro Ramirez","email":"ramidecodes@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ramidecodes/mcp-server-notion.git"},"homepage":"https://github.com/ramidecodes/mcp-server-notion#readme","bugs":{"url":"https://github.com/ramidecodes/mcp-server-notion/issues"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"1.6.1","@notionhq/client":"2.2.16","cors":"2.8.5","dotenv":"16.4.7","express":"4.21.2","zod":"^3.24.2"},"devDependencies":{"@types/cors":"2.8.17","@types/express":"5.0.0","@types/node":"22.13.8","@typescript-eslint/eslint-plugin":"8.26.0","@typescript-eslint/parser":"8.26.0","eslint":"9.21.0","ts-node-dev":"2.0.0","typescript":"5.8.2"},"_id":"@iflow-mcp/mcp-server-notion@1.0.6","gitHead":"8ecfc8399b4d2373aaa01065e7e1af7b73776831","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-Q3NtfgEdX1wn49gWSzMQttvx89Lmi3BwP2Y4twqpgzMPbJe9Cx9W51rkoUNpZUSCDuNY11tGDV3TVewIaeLifA==","shasum":"cd8b34e536e4aaf3228ab7e0ccc042f8a680bdc4","tarball":"https://registry.npmjs.org/@iflow-mcp/mcp-server-notion/-/mcp-server-notion-1.0.6.tgz","fileCount":19,"unpackedSize":119404,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCERWcTXXZ/PXscjm28j9qnPrJE0Zp5P2OVB2phH4tQYwIhAIsXjXoL2HbWREJWhdkTUOKOi6AXCL753AwDxgYj+q7u"}]},"_npmUser":{"name":"chatflowdev","email":"chatflowdev@gmail.com"},"directories":{},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-notion_1.0.6_1761637693258_0.05487428898517366"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-28T07:48:13.159Z","1.0.6":"2025-10-28T07:48:13.520Z","modified":"2025-10-28T07:48:13.887Z"},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"description":"A Model Context Protocol (MCP) server that exposes the official Notion SDK","homepage":"https://github.com/ramidecodes/mcp-server-notion#readme","keywords":["mcp","notion","model-context-protocol","llm","mcp-server","cursor","modelcontextprotocol","notion-api","notion-sdk-js"],"repository":{"type":"git","url":"git+https://github.com/ramidecodes/mcp-server-notion.git"},"author":{"name":"Ramiro Ramirez","email":"ramidecodes@gmail.com"},"bugs":{"url":"https://github.com/ramidecodes/mcp-server-notion/issues"},"license":"MIT","readme":"# Notion MCP Server\n\nA Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.\n\n\n \"Notion\n\n\n## Quick Start\n\n### 1. Set up your Notion integration\n\n1. Go to [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations)\n2. Create a new integration\n3. Copy the API key\n\n### 2. Connect your Notion pages to the integration\n\nFor your integration to access Notion content, you need to explicitly share your pages or databases with it:\n\n1. Navigate to the Notion page or database you want to access through the integration\n2. Click the \"Share\" button in the top-right corner\n3. In the \"Add people, groups, or integrations\" field, select your integration from the dropdown list\n4. Click \"Invite\"\n5. Repeat for each page or database you want to make accessible\n\n**Note:** An integration only has access to pages and databases that have been explicitly shared with it. Child pages automatically inherit access from parent pages.\n\n### 3. Add to your AI assistant\n\nYou can add this MCP server to Claude Desktop, Cursor AI, or Claude.ai using either of these configuration formats:\n\n#### Command Line Format\n\n```bash\nnpx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key\n```\n\n#### JSON Configuration Format\n\n```json\n{\n \"mcpServers\": {\n \"Notion\": {\n \"command\": \"npx\",\n \"args\": [\n \"@ramidecodes/mcp-server-notion@latest\",\n \"-y\",\n \"--api-key=your-notion-integration-key\"\n ]\n }\n }\n}\n```\n\nReplace `your-notion-integration-key` with the API key from step 1.\n\n### Setup Instructions\n\n- **Claude Desktop**: Settings > Advanced > Model Context Protocol\n- **Cursor AI**: Settings > AI > MCP Servers\n- **Claude.ai (Web)**: Profile > Settings > API & Integrations > Model Context Protocol\n\n## Available Tools\n\nThe server provides tools for interacting with Notion:\n\n- **Search**: Find pages or databases\n- **Databases**: Query and retrieve database entries\n- **Pages**: Create, retrieve, and update pages\n- **Blocks**: Manage content blocks (paragraphs, lists, etc.)\n- **Users**: List users and get user information\n- **Comments**: Create and list comments\n- **Link Previews**: Create link previews for URLs\n\n## Alternative Setup Methods\n\n### Using Environment Variables\n\nInstead of passing the API key directly, you can use a `.env` file:\n\n1. Create a `.env` file with:\n\n```\nNOTION_API_KEY=your-notion-integration-key\n```\n\n2. Run the server:\n\n```bash\nnpx @ramidecodes/mcp-server-notion@latest -y\n```\n\n#### JSON Configuration with Environment Variables (for Claude Desktop)\n\nYou can also use environment variables in the JSON configuration format:\n\n```json\n{\n \"mcpServers\": {\n \"Notion\": {\n \"command\": \"npx\",\n \"args\": [\n \"@ramidecodes/mcp-server-notion@latest\",\n \"-y\",\n \"--api-key=your-notion-integration-key\"\n ]\n }\n }\n}\n```\n\n### Command Line Options\n\n```\nOPTIONS:\n -h, --help Show help message\n -v, --version Show version information\n --verbose Enable verbose logging\n --env-path Path to .env file\n --api-key Notion API key\n -y Skip confirmation prompts\n```\n\n## Troubleshooting\n\nIf you encounter \"Failed to create client\" errors:\n\n- On Windows, try using `cmd /c` before the npx command\n- On macOS/Linux, try using the full path to npx\n- Test the command in a terminal before adding it to your AI assistant\n\n### Common Issues\n\n- **\"No access to resource\" errors**: Make sure you've shared the specific Notion page or database with your integration (see step 2)\n- **Integration not appearing in share menu**: Try refreshing the page or restarting your browser\n- **Limited capabilities**: Check that your integration has the appropriate capabilities enabled in the Notion integration settings\n\n## Features\n\n- Full Notion API support through the official SDK\n- MCP compliant for seamless AI integration\n- Comprehensive tools for all Notion operations\n- Robust error handling with detailed messages\n- Easy configuration with environment variables\n\nFor detailed documentation on each tool, see the [Tools Documentation](docs/TOOLS.md).\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n","readmeFilename":"README.md","_rev":"1-11995f0bc1f76521f9eeaa45d9c74e82"}