{"_id":"@elia-ori/notion-mcp","_rev":"3-8a89de2e38f4a29890816dcab5254df0","name":"@elia-ori/notion-mcp","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@elia-ori/notion-mcp","version":"0.1.0","keywords":["mcp","notion","server","model-context-protocol","notion-api","claude"],"author":{"name":"Alvin","email":"birthtago@gmail.com"},"license":"MIT","_id":"@elia-ori/notion-mcp@0.1.0","maintainers":[{"name":"elia-ori","email":"birthtago@gmail.com"}],"homepage":"https://github.com/your-username/notion-mcp#readme","bugs":{"url":"https://github.com/your-username/notion-mcp/issues"},"dist":{"shasum":"30ae8e98400cbde10bbada7d8114b4677f429666","tarball":"https://registry.npmjs.org/@elia-ori/notion-mcp/-/notion-mcp-0.1.0.tgz","fileCount":19,"integrity":"sha512-rMhsl1uip1RC3UcwIqAYP8+xb+DExzQwIhUta/vAfDWdtYs3SJIwZbwefzpkXmJdTwyb8LaQjQ4xBPZHbqZ4oQ==","signatures":[{"sig":"MEQCIFRk/Sa1jOyyz7k9ZHe2+lH6PkJkmMfbUdwTu3nB5vxpAiAR4ClaYsXe3gOpBRkBztmoUoTUwgq0M0weOP80ORHsgA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37757},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"3a170ca0c77e5142585879d138e9ac7df9343a94","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","test:connection":"node test-connection.js"},"_npmUser":{"name":"elia-ori","actor":{"name":"elia-ori","type":"user","email":"birthtago@gmail.com"},"email":"birthtago@gmail.com"},"repository":{"url":"git+https://github.com/your-username/notion-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Notion integration","directories":{},"_nodeVersion":"20.18.0","dependencies":{"dotenv":"^16.4.5","@notionhq/client":"^2.2.15","@modelcontextprotocol/sdk":"^1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.0","typescript":"^5.4.5","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/notion-mcp_0.1.0_1751023484578_0.3429657452535402","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@elia-ori/notion-mcp","version":"0.1.1","keywords":["mcp","notion","server","model-context-protocol","notion-api","claude"],"author":{"name":"Alvin","email":"birthtago@gmail.com"},"license":"MIT","_id":"@elia-ori/notion-mcp@0.1.1","maintainers":[{"name":"elia-ori","email":"birthtago@gmail.com"}],"homepage":"https://github.com/your-username/notion-mcp#readme","bugs":{"url":"https://github.com/your-username/notion-mcp/issues"},"dist":{"shasum":"43cb8327d4fa7d0a8237adaa2afa10212b7fd9d5","tarball":"https://registry.npmjs.org/@elia-ori/notion-mcp/-/notion-mcp-0.1.1.tgz","fileCount":19,"integrity":"sha512-znNgfa+xHsCqyobhOlM5TdlhldeRQb9aVCUQrUdpiyJ1XG/J+jqIR5fc1+IdsLQ9Nwd9p023dmJHcfkAMN1f9w==","signatures":[{"sig":"MEYCIQDInbnUj600/sW7UHtBjiijU/kZukzzmWoE596uPfDCjAIhAP7WK5GRAydNOSzUOQl6ut8Bd+chLE3CVC/hhEE6XwJ6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38144},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"7f15eac593abbde22310b19a1bff98d39ff022ca","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","test:connection":"node test-connection.js"},"_npmUser":{"name":"elia-ori","actor":{"name":"elia-ori","type":"user","email":"birthtago@gmail.com"},"email":"birthtago@gmail.com"},"repository":{"url":"git+https://github.com/your-username/notion-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Notion integration","directories":{},"_nodeVersion":"20.18.0","dependencies":{"dotenv":"^16.4.5","@notionhq/client":"^2.2.15","@modelcontextprotocol/sdk":"^1.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.0","typescript":"^5.4.5","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/notion-mcp_0.1.1_1751027234258_0.5539425921860386","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@elia-ori/notion-mcp","version":"0.1.2","description":"MCP server for Notion integration","main":"dist/index.js","type":"module","scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","test:connection":"node test-connection.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.1","@notionhq/client":"^2.2.15","dotenv":"^16.4.5"},"devDependencies":{"@types/node":"^20.14.0","tsx":"^4.16.0","typescript":"^5.4.5"},"keywords":["mcp","notion","server","model-context-protocol","notion-api","claude"],"repository":{"type":"git","url":"git+https://github.com/elia-ori/notion-mcp.git"},"homepage":"https://github.com/elia-ori/notion-mcp#readme","bugs":{"url":"https://github.com/elia-ori/notion-mcp/issues"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"author":{"name":"Alvin","email":"birthtago@gmail.com"},"license":"MIT","_id":"@elia-ori/notion-mcp@0.1.2","gitHead":"464299adb060eada36ec0540637bf7e14a078676","types":"./dist/index.d.ts","_nodeVersion":"20.18.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-aFsLky01ipJPIpkt6VGcISeY+BA/P+nASSC3r3Dj833jPAz4KM7UhcE5cmATgUnp+fW5E5qig+eatRDypFnkOw==","shasum":"4911a168610ee4deaf829c04a4ef77f274259084","tarball":"https://registry.npmjs.org/@elia-ori/notion-mcp/-/notion-mcp-0.1.2.tgz","fileCount":19,"unpackedSize":38129,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGE7hOxCnhynwYSTxhPxFm5wib0O3/RphcLnSRhjYOScAiA4B3+J53wEas8DhUV0JqyYpex5X81HqeNVBf2l/7tftw=="}]},"_npmUser":{"name":"elia-ori","email":"birthtago@gmail.com","actor":{"name":"elia-ori","email":"birthtago@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"elia-ori","email":"birthtago@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/notion-mcp_0.1.2_1751028022866_0.1464847022487279"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-27T11:24:44.507Z","modified":"2025-06-27T12:40:23.188Z","0.1.0":"2025-06-27T11:24:44.867Z","0.1.1":"2025-06-27T12:27:14.428Z","0.1.2":"2025-06-27T12:40:23.029Z"},"bugs":{"url":"https://github.com/elia-ori/notion-mcp/issues"},"author":{"name":"Alvin","email":"birthtago@gmail.com"},"license":"MIT","homepage":"https://github.com/elia-ori/notion-mcp#readme","keywords":["mcp","notion","server","model-context-protocol","notion-api","claude"],"repository":{"type":"git","url":"git+https://github.com/elia-ori/notion-mcp.git"},"description":"MCP server for Notion integration","maintainers":[{"name":"elia-ori","email":"birthtago@gmail.com"}],"readme":"# Notion MCP Server\n\n一個 Model Context Protocol (MCP) 伺服器，用於整合 Notion API，讓 Claude Code 可以直接與你的 Notion 工作區互動。\n\n## 功能\n\n- 搜尋頁面和資料庫\n- 讀取頁面內容和屬性\n- 查詢資料庫內容\n- 建立新頁面\n- 更新頁面屬性\n\n## 前置需求\n\n1. Node.js 18 或更高版本\n2. Notion API Key（從 [Notion Integrations](https://www.notion.so/my-integrations) 取得）\n\n## 安裝方式\n\n您可以選擇從 npm 安裝（推薦）或從原始碼安裝。\n\n### 從 npm 安裝（推薦）\n\n#### 1. 安裝套件\n\n建議在專用目錄安裝 MCP 伺服器：\n\n```bash\nmkdir -p ~/mcp-servers/notion\ncd ~/mcp-servers/notion\nnpm init -y\nnpm install @elia-ori/notion-mcp\n```\n\n#### 2. 在 Claude Code 註冊\n\n```bash\nclaude mcp add notion -e NOTION_API_KEY=your_actual_api_key -- node ~/mcp-servers/notion/node_modules/@elia-ori/notion-mcp/dist/index.js\n```\n\n記得替換：\n- `your_actual_api_key` 為您的 Notion API Key\n- `~` 會自動展開為您的家目錄路徑\n\n### 從原始碼安裝\n\n#### 1. 複製專案並安裝依賴\n\n```bash\ncd ~/Projects/mcp-servers  # 或你的 MCP 專案目錄\ngit clone https://github.com/elia-ori/notion-mcp.git\ncd notion-mcp\nnpm install\n```\n\n#### 2. 建置專案\n\n```bash\nnpm run build\n```\n\n#### 3. 在 Claude Code 中註冊 MCP 伺服器\n\n```bash\nclaude mcp add notion -e NOTION_API_KEY=your_actual_api_key -- node ~/Projects/mcp-servers/notion-mcp/dist/index.js\n```\n\n## Notion 設定\n\n### 1. 建立 Notion Integration\n\n1. 前往 https://www.notion.so/my-integrations\n2. 點擊 \"New integration\"\n3. 給 integration 一個名稱（例如 \"Claude Code MCP\"）\n4. 選擇你要連接的工作區\n5. 複製 \"Internal Integration Token\" 作為你的 API Key\n\n### 2. 授權 Integration 存取頁面\n\n在 Notion 中，你需要明確授權 integration 存取特定頁面或資料庫：\n\n1. 開啟你想要存取的頁面或資料庫\n2. 點擊右上角的 \"...\" 選單\n3. 在 \"Connections\" 區域，點擊 \"Add connections\"\n4. 搜尋並選擇你的 integration\n\n## 使用方式\n\n在 Claude Code 中，你可以使用以下工具：\n\n### 搜尋頁面\n```\n使用 notion_search_pages 工具搜尋 \"專案計畫\"\n```\n\n### 讀取頁面內容\n```\n使用 notion_get_page_content 工具讀取頁面 ID xxx-xxx-xxx 的內容\n```\n\n### 查詢資料庫\n```\n使用 notion_query_database 工具查詢資料庫 ID xxx-xxx-xxx\n```\n\n### 建立新頁面\n```\n使用 notion_create_page 工具在頁面 ID xxx-xxx-xxx 下建立標題為 \"新任務\" 的頁面\n```\n\n## 可用工具\n\n- `notion_search_pages` - 搜尋 Notion 頁面\n- `notion_search_databases` - 搜尋 Notion 資料庫\n- `notion_get_page` - 取得特定頁面的屬性\n- `notion_get_page_content` - 取得頁面的內容區塊\n- `notion_query_database` - 查詢資料庫（支援篩選和排序）\n- `notion_create_page` - 建立新頁面\n\n## 開發\n\n### 開發模式\n```bash\nnpm run dev\n```\n\n### 建置\n```bash\nnpm run build\n```\n\n### 專案結構\n```\nnotion-mcp/\n├── src/\n│   ├── index.ts          # 入口點\n│   ├── server/\n│   │   └── index.ts      # MCP 伺服器實作\n│   ├── notion/\n│   │   └── client.ts     # Notion API 客戶端\n│   └── utils/\n│       └── notion-utils.ts # 工具函數\n├── package.json\n├── tsconfig.json\n├── .env.example\n└── README.md\n```\n\n## 疑難排解\n\n### 找不到頁面或資料庫\n確保你已經在 Notion 中授權 integration 存取該頁面或資料庫。\n\n### API Key 無效\n檢查 `.env` 檔案中的 API Key 是否正確，並確保 integration 仍然有效。\n\n### 權限錯誤\n確保 integration 有足夠的權限（讀取/寫入）來執行所需的操作。\n\n## 授權\n\nMIT License","readmeFilename":"README.md"}