{"id":25972814,"url":"https://github.com/ramidecodes/mcp-server-notion","last_synced_at":"2026-05-06T15:31:59.840Z","repository":{"id":280495355,"uuid":"942160270","full_name":"ramidecodes/mcp-server-notion","owner":"ramidecodes","description":"A Model Context Protocol server wrapping the official Notion SDK","archived":false,"fork":false,"pushed_at":"2025-03-03T19:11:38.000Z","size":53,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-03T19:23:08.554Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ramidecodes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2025-03-03T17:08:10.000Z","updated_at":"2025-03-03T19:11:42.000Z","dependencies_parsed_at":"2025-03-03T19:34:30.325Z","dependency_job_id":null,"html_url":"https://github.com/ramidecodes/mcp-server-notion","commit_stats":null,"previous_names":["ramidecodes/mcp-server-notion"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramidecodes%2Fmcp-server-notion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramidecodes%2Fmcp-server-notion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramidecodes%2Fmcp-server-notion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramidecodes%2Fmcp-server-notion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ramidecodes","download_url":"https://codeload.github.com/ramidecodes/mcp-server-notion/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241945530,"owners_count":20046870,"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-03-05T01:17:30.249Z","updated_at":"2026-05-06T15:31:59.834Z","avatar_url":"https://github.com/ramidecodes.png","language":"TypeScript","funding_links":[],"categories":["Other Tools and Integrations","Note-Taking and Knowledge Bases","🌐 Web Development"],"sub_categories":["How to Submit"],"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\u003ca href=\"https://glama.ai/mcp/servers/bjc5iac7gt\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/bjc5iac7gt/badge\" alt=\"Notion Server MCP server\" /\u003e\n\u003c/a\u003e\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 \u003e Advanced \u003e Model Context Protocol\n- **Cursor AI**: Settings \u003e AI \u003e MCP Servers\n- **Claude.ai (Web)**: Profile \u003e Settings \u003e API \u0026 Integrations \u003e 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 \u003cpath\u003e       Path to .env file\n  --api-key \u003ckey\u003e         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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Framidecodes%2Fmcp-server-notion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Framidecodes%2Fmcp-server-notion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Framidecodes%2Fmcp-server-notion/lists"}