{"_id":"notion-lite-mcp","_rev":"2-e90d7834831cd752c01f695832a0f3a1","name":"notion-lite-mcp","dist-tags":{"latest":"1.1.0"},"versions":{"0.0.0-stage":{"name":"notion-lite-mcp","version":"0.0.0-stage","_id":"notion-lite-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"agent_craft_studio","email":"plusminus10102020@gmail.com"}],"dist":{"shasum":"f0c9f0fe59c57781a04be1e60e59883c929b3ff3","tarball":"https://registry.npmjs.org/notion-lite-mcp/-/notion-lite-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-aRY9LaMqcZKn7BYM9etx2YtMKENDuojUiCxvRH+K2UU7wUhdfAqGJY6f9yoUptRHbUNG+DV668CR7ux1Qn3wNw==","signatures":[{"sig":"MEUCIGpBfvfXQf4rsyt3GpNFT4AYnb0AGKn3eKYS5tbHr7m6AiEAiDfcPgz++fDF43amOF8XUZ0RTnKvkAalHKn/8uPHHOQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":337},"_npmUser":{"name":"agent_craft_studio","email":"plusminus10102020@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.1.0":{"_id":"notion-lite-mcp@1.1.0","bin":{"notion-lite-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/sinobure/earn-mcp-plugins/issues"},"dist":{"shasum":"fc5a5bfbefe02e8da6fb4e182df481b57abbc2c7","tarball":"https://registry.npmjs.org/notion-lite-mcp/-/notion-lite-mcp-1.1.0.tgz","fileCount":8,"integrity":"sha512-2yJWsyG1pVydlVy2db6HZowEZnvHmDmCqwtRtDfqSIXxA5IGy7kelcgQtWZeqH1KVVnJBSgxSMwfH57gfqnz+w==","signatures":[{"sig":"MEUCIQDznCe4BedO1UjTqTovsIBsYpy4Fk0IuI/cDXyHhN/RMwIgNwInFGM5pm+zh/XC9WovgSt+gngt7SrAuuUwk5sWCkQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCILVw3cCanzIflDUvKLNcHGK1aeHngnpLbK67/j/m0VwIhAOCXtiylo76xVCM0cPffh0UO52vSTBAVAdPHltEPWXgF"}],"unpackedSize":50722},"name":"notion-lite-mcp","type":"module","author":{"url":"https://github.com/sinobure","name":"Kento Watarai"},"engines":{"node":">=18"},"gitHead":"1c32b64cd87ed61e728b78c1d7bb908d57703f65","license":"MIT","scripts":{"test":"vitest run","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js',0o755)\"","start":"node dist/index.js","test:ui":"vitest --ui","test:watch":"vitest","prepublishOnly":"npm test && npm run build"},"version":"1.1.0","_npmUser":{"name":"agent_craft_studio","email":"plusminus10102020@gmail.com"},"homepage":"https://github.com/sinobure/earn-mcp-plugins/tree/main/notion-lite-mcp#readme","keywords":["ai","claude","llm","mcp","mcp-server","modelcontextprotocol","notion","notion-api","notion-mcp"],"repository":{"url":"git+https://github.com/sinobure/earn-mcp-plugins.git","type":"git","directory":"notion-lite-mcp"},"_npmVersion":"10.9.3","description":"Lightweight MCP server for searching, reading, and appending to Notion pages via the official Notion API","directories":{},"maintainers":[{"name":"agent_craft_studio","email":"plusminus10102020@gmail.com"}],"_nodeVersion":"22.18.0","dependencies":{"@notionhq/client":"^2.3.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","@vitest/ui":"^3.2.4","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/notion-lite-mcp_1.1.0_1791948263410_0.20879310978038546"}}},"time":{"created":"2026-10-14T03:23:47.911Z","modified":"2026-10-14T03:24:23.662Z","0.0.0-stage":"2026-10-14T03:23:47.911Z","1.1.0":"2026-10-14T03:24:23.510Z"},"description":"Lightweight MCP server for searching, reading, and appending to Notion pages via the official Notion API","maintainers":[{"name":"agent_craft_studio","email":"plusminus10102020@gmail.com"}],"readme":"# notion-lite-mcp\r\n\r\n[![CI](https://github.com/sinobure/earn-mcp-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/sinobure/earn-mcp-plugins/actions/workflows/ci.yml)\r\n[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\r\n\r\nNotion の公式 SDK を使い、Claude Desktop / Claude Code からページの検索・読み取り・追記ができる軽量 MCP サーバーです。\r\n\r\n---\r\n\r\n## Quick start (English)\r\n\r\n```bash\r\nclaude mcp add notion -e NOTION_API_KEY=<your integration token> -- npx -y notion-lite-mcp\r\n```\r\n\r\nTools: `search_notion`, `get_page`, `list_children`, `query_database` (filter/sorts as JSON), `append_to_page` and `create_page` (light Markdown: headings, lists, to-dos, quotes, code). Read tools retry on 429; writes never auto-retry. Search, read, query and write Notion pages via the official Notion API. Create an internal integration at https://www.notion.so/profile/integrations and share the pages with it. Tool descriptions and error hints are in English; the detailed guide below is in Japanese.\r\n\r\n## 必要なもの\r\n\r\n- Node.js 18 以上\r\n- Notion Integration（内部インテグレーション）のシークレットキー\r\n\r\n---\r\n\r\n## Notion Integration の作成手順\r\n\r\n### 1. インテグレーションを作成する\r\n\r\n1. [https://www.notion.so/profile/integrations](https://www.notion.so/profile/integrations) にアクセス\r\n2. 「新しいインテグレーション」をクリック\r\n3. 名前を入力（例: `Claude MCP`）し、ワークスペースを選択\r\n4. 「送信」をクリック\r\n5. 表示された **「内部インテグレーションシークレット」** をコピーして保存する（`ntn_` で始まる文字列。以前に作成したものは `secret_` 始まりで、どちらも使えます）\r\n6. 「機能」タブで「コンテンツを読み取る」「コンテンツを更新する」が有効か確認する（`append_to_page` には更新権限が必要）\r\n\r\n### 2. ページをインテグレーションに共有する\r\n\r\nNotion の各ページ（またはデータベース）はデフォルトでインテグレーションからアクセスできません。  \r\nアクセスしたいページを開いて共有設定を行います。\r\n\r\n1. 対象ページの右上「…」メニュー → 「コネクト」(英語UIでは Connections)をクリック\r\n2. 作成したインテグレーション（例: `Claude MCP`）を選択\r\n3. 「確認」してアクセスを許可\r\n\r\n> サブページがある場合、親ページを共有すれば子ページにも自動的にアクセスできます。\r\n\r\n---\r\n\r\n## インストール\r\n\r\n```bash\r\nnpm install -g notion-lite-mcp\r\n```\r\n\r\nまたは npx で使う（インストール不要）:\r\n\r\n```bash\r\nnpx notion-lite-mcp\r\n```\r\n\r\n---\r\n\r\n## Claude Desktop への登録\r\n\r\n設定ファイルの場所:\r\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\r\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\r\n\r\n### グローバルインストール済みの場合\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"notion-lite\": {\r\n      \"command\": \"notion-lite-mcp\",\r\n      \"env\": {\r\n        \"NOTION_API_KEY\": \"ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### npx を使う場合\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"notion-lite\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"notion-lite-mcp\"],\r\n      \"env\": {\r\n        \"NOTION_API_KEY\": \"ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## Claude Code への登録\r\n\r\n```bash\r\nclaude mcp add notion-lite -e NOTION_API_KEY=ntn_xxxx -- npx -y notion-lite-mcp\r\n```\r\n\r\nまたは、プロジェクト直下の `.mcp.json` に追記:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"notion-lite\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"notion-lite-mcp\"],\r\n      \"env\": {\r\n        \"NOTION_API_KEY\": \"ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## 提供ツール\r\n\r\n| ツール | 種別 | 説明 |\r\n|---|---|---|\r\n| `search_notion` | 読み取り | タイトルでページ/DBを検索。`limit`(1-100)、`type`(page/database)、`cursor` |\r\n| `get_page` | 読み取り | ページ本文とプロパティをテキスト化。入れ子ブロックを `max_depth`(既定3)まで展開、`max_chars`(既定20000)で打ち切り |\r\n| `list_children` | 読み取り | 直下の子ブロック一覧（type・プレビュー・ID） |\r\n| `query_database` | 読み取り | DB の行を取得（タイトル・URL・主要プロパティ）。`limit`、`cursor`、`filter` / `sorts`（Notion API の JSON 文字列） |\r\n| `create_page` | **書き込み** | 既存ページの下に新規ページを作成（`parent_page_id`、`title`、任意の `content`。書式は `append_to_page` と同じ） |\r\n| `append_to_page` | **書き込み** | ページ末尾に追記。行頭の `# ` `## ` `### `（見出し）、`- `（箇条書き）、`1. `（番号）、`- [ ]` `- [x]`（To-do）、`> `（引用）、`---`（区切り線）、``` で囲んだ範囲（コード）を対応ブロックに変換。1行2000文字超は自動分割、100ブロックごとにバッチ送信 |\r\n\r\n検索・DB取得は続きがあると `next_cursor` を返します。次の呼び出しの `cursor` に渡してください。\r\n\r\n**使用例（Claude への質問）**\r\n> 「Notionで「議事録」というページを探して」「そのページを読んで」「本日の作業完了と追記して」\r\n\r\n**`get_page` のレスポンス例**\r\n```\r\n# プロジェクト計画書\r\n(id: 1234abcd-12ab-12ab-12ab-1234abcd5678)\r\n\r\n## 概要\r\nこのプロジェクトでは...\r\n1. 手順1\r\n2. 手順2\r\n▸ 折りたたみ見出し\r\n  中身（入れ子は2スペースずつインデント）\r\n> 引用\r\n[x] 完了済み項目\r\n```\r\n\r\n対応ブロック: 見出し1-3、段落、箇条書き、番号付き（連番）、To-do、トグル(`▸`)、引用(`>`)、コールアウト、コード、区切り線、テーブル行、数式、ブックマーク/埋め込み。画像・動画・ファイルは `[image]` 等のプレースホルダ、書式（太字・リンク等）は除いたプレーンテキストです。子ページ/子DBは展開せず ID を表示します（`get_page` / `query_database` で別途取得）。\r\n\r\n---\r\n\r\n## ページ ID の確認方法\r\n\r\nNotion のページ URL から ID を取得できます。\r\n\r\n```\r\nhttps://www.notion.so/My-Page-1234abcd12ab12ab12ab1234abcd5678\r\n                                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\r\n                                この32文字がページID\r\n```\r\n\r\nまたはハイフン付き形式:\r\n```\r\n1234abcd-12ab-12ab-12ab-1234abcd5678\r\n```\r\n\r\nどちらの形式でも `notion-lite-mcp` はそのまま受け付けます。\r\n\r\n---\r\n\r\n## トラブルシュート\r\n\r\n| 症状 | 原因と対処 |\r\n|---|---|\r\n| `NOTION_API_KEY is not set ...` | 設定の `env` に `NOTION_API_KEY` が無い。サーバーは起動したままツール呼び出し時にこの案内を返します。設定後にクライアントを再起動 |\r\n| `401 unauthorized` | トークンが無効。インテグレーションのシークレットを再コピー |\r\n| `404 object_not_found` | ページが存在しないか **インテグレーションに共有されていない**。ページの「…」→「コネクト」で追加 |\r\n| `403 restricted_resource` | インテグレーションの「機能」で読み取り/更新が無効。有効化する |\r\n| 検索結果が0件 | 共有済みのページしか検索できません。親ページを共有してください |\r\n| `429 rate_limited` | 数秒待って再実行 |\r\n\r\n---\r\n\r\n## ローカル開発\r\n\r\n```bash\r\ngit clone https://github.com/sinobure/earn-mcp-plugins.git\r\ncd earn-mcp-plugins/notion-lite-mcp\r\nnpm install\r\nnpm run build      # dist/ を生成\r\nnpm test\r\nNOTION_API_KEY=ntn_xxxx npm start\r\n```\r\n\r\n---\r\n\r\n## 既知の制約\r\n\r\n- 読み取りは書式（太字・リンク等）を落としたプレーンテキストです。ブロックの更新・削除、DB 行の作成・プロパティ更新はできません（追記と、ページ配下への新規ページ作成のみ）。\r\n- 未対応のブロック型（synced_block など）は `[type]` と表示されます。\r\n- 読み取り系は HTTP 429（レート制限）のとき最大2回自動リトライします。書き込みは重複を避けるため自動リトライしません。\r\n- Notion API `2022-06-28` 固定（`@notionhq/client` v2）です。複数データソースを持つ新方式の DB には未対応です。\r\n- エラーメッセージのヒントは英語です。\r\n\r\n## ライセンス\r\n\r\nMIT\r\n","readmeFilename":"README.md","homepage":"https://github.com/sinobure/earn-mcp-plugins/tree/main/notion-lite-mcp#readme","keywords":["ai","claude","llm","mcp","mcp-server","modelcontextprotocol","notion","notion-api","notion-mcp"],"repository":{"url":"git+https://github.com/sinobure/earn-mcp-plugins.git","type":"git","directory":"notion-lite-mcp"},"author":{"url":"https://github.com/sinobure","name":"Kento Watarai"},"bugs":{"url":"https://github.com/sinobure/earn-mcp-plugins/issues"},"license":"MIT"}