{"_id":"@agentx-ai/notion-mcp-server","_rev":"5-0e5108d1a2b0b448c9f36c82ddeef866","name":"@agentx-ai/notion-mcp-server","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@agentx-ai/notion-mcp-server","version":"1.0.0","keywords":["notion","api","mcp","server","agentx","ai"],"author":{"name":"AgentX AI"},"license":"MIT","_id":"@agentx-ai/notion-mcp-server@1.0.0","maintainers":[{"name":"robinxw","email":"robin@agentx.so"}],"homepage":"https://github.com/AgentX-ai/AgentX-mcp-servers/tree/main/notion-mcp-server#readme","bugs":{"url":"https://github.com/AgentX-ai/AgentX-mcp-servers/issues"},"bin":{"notion-mcp-server":"bin/cli.mjs"},"dist":{"shasum":"e3f1231656a86bba57f7963ffa15e899eec75a51","tarball":"https://registry.npmjs.org/@agentx-ai/notion-mcp-server/-/notion-mcp-server-1.0.0.tgz","fileCount":35,"integrity":"sha512-qYIAMAPV/vLap98A4fy2n90ONj+EWtMcEmjYeysLhevZfTZIuDjEFEIc7DVxmGHtW6ozaDQBLfqos1duzG+3Cg==","signatures":[{"sig":"MEUCIERmKhwF90P4fxjItAJcAQdBY/yjJZJldUqcm9SVmh8mAiEApkM3+a/tff09pkD4tYABxqxfneLrMCkRXwH91jHgMdk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2045470},"main":"index.js","type":"module","gitHead":"9eb8ec3e3588aff626452dc36962740f6d85d8b5","scripts":{"dev":"tsx watch scripts/start-server.ts","build":"tsc -build && node scripts/build-cli.js"},"_npmUser":{"name":"robinxw","actor":{"name":"robinxw","type":"user","email":"robin@agentx.so"},"email":"robin@agentx.so"},"repository":{"url":"git+ssh://git@github.com/AgentX-ai/AgentX-mcp-servers.git","type":"git"},"_npmVersion":"10.2.3","description":"AgentX MCP server for Notion API with user-friendly environment variables","directories":{},"_nodeVersion":"20.10.0","dependencies":{"zod":"3.24.1","axios":"^1.8.4","which":"^5.0.0","express":"^4.21.2","mustache":"^4.2.0","form-data":"^4.0.1","openapi-types":"^12.1.3","openapi-client-axios":"^7.5.5","openapi-schema-validator":"^12.1.3","@modelcontextprotocol/sdk":"^1.13.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.3","multer":"1.4.5-lts.1","openai":"^4.91.1","vitest":"^3.1.1","esbuild":"^0.25.2","typescript":"^5.8.2","@types/node":"^20.17.16","@types/which":"^3.0.4","@types/express":"^5.0.0","@types/js-yaml":"^4.0.9","@types/mustache":"^4.2.5","@anthropic-ai/sdk":"^0.33.1","@types/json-schema":"^7.0.15","@vitest/coverage-v8":"3.1.1"},"_npmOperationalInternal":{"tmp":"tmp/notion-mcp-server_1.0.0_1750292648884_0.929674877296734","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@agentx-ai/notion-mcp-server","version":"1.0.1","keywords":["notion","api","mcp","server","agentx","ai"],"author":{"name":"AgentX AI"},"license":"MIT","_id":"@agentx-ai/notion-mcp-server@1.0.1","maintainers":[{"name":"robinxw","email":"robin@agentx.so"}],"homepage":"https://github.com/AgentX-ai/AgentX-mcp-servers/tree/main/notion-mcp-server#readme","bugs":{"url":"https://github.com/AgentX-ai/AgentX-mcp-servers/issues"},"bin":{"notion-mcp-server":"bin/cli.mjs"},"dist":{"shasum":"fcde7f344d856ac44f43c3971ca5b4383a366046","tarball":"https://registry.npmjs.org/@agentx-ai/notion-mcp-server/-/notion-mcp-server-1.0.1.tgz","fileCount":35,"integrity":"sha512-swckE3qIlC0dpIPcKeyi8PpXTaxwBSR5mqeh9ck7xFUkJpBMK3uqX8NNciYUgaF4+VfQ5rlU9moieuKhmxYPLw==","signatures":[{"sig":"MEUCIQCT/SwQpumRYA64ZatBbsRUPG47k8mP262wbr8/CvsJWwIgf3i2I2TuAFi7QnP0thDKqAPd171V9AhNQd02M68ow7U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2045868},"main":"index.js","type":"module","gitHead":"9eb8ec3e3588aff626452dc36962740f6d85d8b5","scripts":{"dev":"tsx watch scripts/start-server.ts","build":"tsc -build && node scripts/build-cli.js"},"_npmUser":{"name":"robinxw","actor":{"name":"robinxw","type":"user","email":"robin@agentx.so"},"email":"robin@agentx.so"},"repository":{"url":"git+ssh://git@github.com/AgentX-ai/AgentX-mcp-servers.git","type":"git"},"_npmVersion":"10.2.3","description":"AgentX MCP server for Notion API with user-friendly environment variables","directories":{},"_nodeVersion":"20.10.0","dependencies":{"zod":"3.24.1","axios":"^1.8.4","which":"^5.0.0","express":"^4.21.2","mustache":"^4.2.0","form-data":"^4.0.1","openapi-types":"^12.1.3","openapi-client-axios":"^7.5.5","openapi-schema-validator":"^12.1.3","@modelcontextprotocol/sdk":"^1.13.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.3","multer":"1.4.5-lts.1","openai":"^4.91.1","vitest":"^3.1.1","esbuild":"^0.25.2","typescript":"^5.8.2","@types/node":"^20.17.16","@types/which":"^3.0.4","@types/express":"^5.0.0","@types/js-yaml":"^4.0.9","@types/mustache":"^4.2.5","@anthropic-ai/sdk":"^0.33.1","@types/json-schema":"^7.0.15","@vitest/coverage-v8":"3.1.1"},"_npmOperationalInternal":{"tmp":"tmp/notion-mcp-server_1.0.1_1750297721588_0.41406585002732466","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@agentx-ai/notion-mcp-server","version":"1.1.0","keywords":["notion","api","mcp","server","agentx","ai"],"author":{"name":"AgentX AI"},"license":"MIT","_id":"@agentx-ai/notion-mcp-server@1.1.0","maintainers":[{"name":"robinxw","email":"robin@agentx.so"}],"homepage":"https://github.com/AgentX-ai/AgentX-mcp-servers/tree/main/notion-mcp-server#readme","bugs":{"url":"https://github.com/AgentX-ai/AgentX-mcp-servers/issues"},"bin":{"notion-mcp-server":"bin/cli.mjs"},"dist":{"shasum":"51147c7569fb3168f912f97b8a00be58e54275bc","tarball":"https://registry.npmjs.org/@agentx-ai/notion-mcp-server/-/notion-mcp-server-1.1.0.tgz","fileCount":35,"integrity":"sha512-HXWzs9iDD7z2k7DxybkUuogwMqcap1rYyMO7IKuzZ56m5XPRsv+ny9OYPaECtsauxgtiF+KIQD/oLw4XMIAZHQ==","signatures":[{"sig":"MEQCIGKP5qdQrCjETLk1aXV/XBWYisWvf2vmIYF4AHqlUsK4AiAsNzJ0wZA95dKShOQ/iLR3TB5FTZwuwn1lhoWaX66Fxw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2046959},"main":"index.js","type":"module","gitHead":"a3be76af3238442ed9ebfd92d488d683fa72e3f9","scripts":{"dev":"tsx watch scripts/start-server.ts","build":"tsc -build && node scripts/build-cli.js"},"_npmUser":{"name":"robinxw","actor":{"name":"robinxw","type":"user","email":"robin@agentx.so"},"email":"robin@agentx.so"},"repository":{"url":"git+ssh://git@github.com/AgentX-ai/AgentX-mcp-servers.git","type":"git"},"_npmVersion":"11.4.2","description":"AgentX MCP server for Notion API with user-friendly environment variables","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"3.24.1","axios":"^1.8.4","which":"^5.0.0","express":"^4.21.2","mustache":"^4.2.0","form-data":"^4.0.1","openapi-types":"^12.1.3","openapi-client-axios":"^7.5.5","openapi-schema-validator":"^12.1.3","@modelcontextprotocol/sdk":"^1.13.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.3","multer":"1.4.5-lts.1","openai":"^4.91.1","vitest":"^3.1.1","esbuild":"^0.25.2","typescript":"^5.8.2","@types/node":"^20.17.16","@types/which":"^3.0.4","@types/express":"^5.0.0","@types/js-yaml":"^4.0.9","@types/mustache":"^4.2.5","@anthropic-ai/sdk":"^0.33.1","@types/json-schema":"^7.0.15","@vitest/coverage-v8":"3.1.1"},"_npmOperationalInternal":{"tmp":"tmp/notion-mcp-server_1.1.0_1750410377498_0.28087313897056365","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-06-19T00:24:08.780Z","modified":"2025-06-28T23:24:27.616Z","1.0.0":"2025-06-19T00:24:09.103Z","1.0.1":"2025-06-19T01:48:41.821Z","1.1.0":"2025-06-20T09:06:17.695Z"},"bugs":{"url":"https://github.com/AgentX-ai/AgentX-mcp-servers/issues"},"author":{"name":"AgentX AI"},"license":"MIT","homepage":"https://github.com/AgentX-ai/AgentX-mcp-servers/tree/main/notion-mcp-server#readme","keywords":["notion","api","mcp","server","agentx","ai"],"repository":{"url":"git+ssh://git@github.com/AgentX-ai/AgentX-mcp-servers.git","type":"git"},"description":"AgentX MCP server for Notion API with user-friendly environment variables","maintainers":[{"email":"robin@agentx.so","name":"robinxw"},{"email":"luis@agentx.so","name":"luis-agentx"},{"email":"marcin@agentx.so","name":"marmichalak"}],"readme":"# AgentX Notion MCP Server\n\n(Folk from https://github.com/makenotion/notion-mcp-server)\n\n[![Website](https://img.shields.io/badge/Website-🌐-purple)](https://www.agentx.so/mcp/notion)\n\nThis project implements an [MCP server](https://spec.modelcontextprotocol.io/) for the [Notion API](https://developers.notion.com/reference/intro) with **user-friendly environment variables**.\n\n![mcp-demo](https://github.com/user-attachments/assets/e3ff90a7-7801-48a9-b807-f7dd47f0d3d6)\n\n## ✨ Features\n\n- 🔧 **User-friendly configuration** - Simple environment variables instead of complex JSON\n- 🔄 **Backward compatibility** - Still supports legacy `OPENAPI_MCP_HEADERS`\n- 🚀 **Easy setup** - Just set `NOTION_API_TOKEN` and optionally `NOTION_VERSION`\n- 📚 **Full Notion API support** - All Notion API endpoints available\n- 🛡️ **Secure** - Proper authentication and error handling\n\n### Installation\n\n#### 1. Setting up Integration in Notion:\n\nGo to [https://www.notion.so/profile/integrations](https://www.notion.so/profile/integrations) and create a new **internal** integration or select an existing one.\n\n![Creating a Notion Integration token](docs/images/integrations-creation.png)\n\nWhile we limit the scope of Notion API's exposed (for example, you will not be able to delete databases via MCP), there is a non-zero risk to workspace data by exposing it to LLMs. Security-conscious users may want to further configure the Integration's _Capabilities_.\n\nFor example, you can create a read-only integration token by giving only \"Read content\" access from the \"Configuration\" tab:\n\n![Notion Integration Token Capabilities showing Read content checked](docs/images/integrations-capabilities.png)\n\n#### 2. Connecting content to integration:\n\nEnsure relevant pages and databases are connected to your integration.\n\nTo do this, visit the **Access** tab in your internal integration settings. Edit access and select the pages you'd like to use.\n![Integration Access tab](docs/images/integration-access.png)\n\n![Edit integration access](docs/images/page-access-edit.png)\n\nAlternatively, you can grant page access individually. You'll need to visit the target page, and click on the 3 dots, and select \"Connect to integration\".\n\n![Adding Integration Token to Notion Connections](docs/images/connections.png)\n\n#### 3. Adding MCP config to your client:\n\n##### Using npm:\n\nAdd the following to your `.cursor/mcp.json` or `claude_desktop_config.json` (MacOS: `~/Library/Application\\ Support/Claude/claude_desktop_config.json`)\n\n```javascript\n{\n  \"mcpServers\": {\n    \"notionApi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentx-ai/notion-mcp-server\"],\n      \"env\": {\n        \"NOTION_API_TOKEN\": \"ntn_****\",\n        \"NOTION_VERSION\": \"2022-06-28\"\n      }\n    }\n  }\n}\n```\n\n**Note:** `NOTION_VERSION` is optional and defaults to `\"2022-06-28\"` if not provided.\n\n##### Using Docker:\n\nThere are two options for running the MCP server with Docker:\n\n###### Option 1: Using the official Docker Hub image:\n\nAdd the following to your `.cursor/mcp.json` or `claude_desktop_config.json`:\n\n```javascript\n{\n  \"mcpServers\": {\n    \"notionApi\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"-e\", \"NOTION_API_TOKEN\",\n        \"-e\", \"NOTION_VERSION\",\n        \"mcp/notion\"\n      ],\n      \"env\": {\n        \"NOTION_API_TOKEN\": \"ntn_****\",\n        \"NOTION_VERSION\": \"2022-06-28\"\n      }\n    }\n  }\n}\n```\n\nThis approach:\n\n- Uses the official Docker Hub image\n- Uses simple environment variables instead of complex JSON\n- Provides a more user-friendly configuration method\n\n###### Option 2: Building the Docker image locally:\n\nYou can also build and run the Docker image locally. First, build the Docker image:\n\n```bash\ndocker-compose build\n```\n\nThen, add the following to your `.cursor/mcp.json` or `claude_desktop_config.json`:\n\n```javascript\n{\n  \"mcpServers\": {\n    \"notionApi\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"-e\",\n        \"NOTION_API_TOKEN=ntn_****\",\n        \"-e\",\n        \"NOTION_VERSION=2022-06-28\",\n        \"notion-mcp-server\"\n      ]\n    }\n  }\n}\n```\n\n**Legacy Support:** The old `OPENAPI_MCP_HEADERS` environment variable is still supported for backward compatibility, but the new approach is recommended for better user experience.\n\nDon't forget to replace `ntn_****` with your integration secret. Find it from your integration configuration tab:\n\n![Copying your Integration token from the Configuration tab in the developer portal](https://github.com/user-attachments/assets/67b44536-5333-49fa-809c-59581bf5370a)\n\n#### Installing via Smithery\n\n[![smithery badge](https://smithery.ai/badge/@agentx-ai/notion-mcp-server)](https://smithery.ai/server/@agentx-ai/notion-mcp-server)\n\nTo install Notion API Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@agentx-ai/notion-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @agentx-ai/notion-mcp-server --client claude\n```\n\n### Examples\n\n1. Using the following instruction\n\n```\nComment \"Hello MCP\" on page \"Getting started\"\n```\n\nAI will correctly plan two API calls, `v1/search` and `v1/comments`, to achieve the task\n\n2. Similarly, the following instruction will result in a new page named \"Notion MCP\" added to parent page \"Development\"\n\n```\nAdd a page titled \"Notion MCP\" to page \"Development\"\n```\n\n3. You may also reference content ID directly\n\n```\nGet the content of page 1a6b35e6e67f802fa7e1d27686f017f2\n```\n\n### Development (test locally)\n\nBuild\n\n```\nnpm run build\n```\n\nInstall\n\n```\nnpm install -g .\n\n```\n\nTest with modelcontextprotocol/inspector\n\n```\nnpx @modelcontextprotocol/inspector notion-mcp-server\n```\n\nClick:\n\n```\nhttp://localhost:6274/?MCP_PROXY_AUTH_TOKEN=xxxxxxxxxx\n```\n","readmeFilename":"README.md"}