Notion CLI API Skill — DevOps skill for Claude Code

notion-cli-api-skill

NotionをClaudeから扱うためのスキル。 Claudeに頼むと、Notionが黙って値を壊す落とし穴を避けながら編集したり、Notionのコメントを拾って返信したりする。

中身はNotion REST APIへの薄いアクセスで、どのデータを読み書きするかは決めない。 他のスキルがNotionを読み書きするときの部品としても使える。

必要なもの

• Claude Code
• Notionの Internal Integration
• Python 3.11以上と uv
• sh と curl（WindowsではGit Bash）
• Claudeに接続した公式の Notion MCP（コメントに答えてもらうときだけ）

インストール

スキルのフォルダでクローンする。フォルダ名はリポジトリ名のままでよい。

git clone https://github.com/junyatakechi/notion-cli-api-skill.git ~/.claude/skills/notion-cli-api-skill

特定のプロジェクトだけで使うなら、`<プロジェクト>/.claude/skills/` の中でクローンする。

セットアップ

Pythonとuvを入れる

Windowsでは、[winget](https://learn.microsoft.com/windows/package-manager/winget/)で入れる。

winget install --id Python.Python.3.14 --exact

winget install --id astral-sh.uv --exact

macOS・Linuxでは、[uvの公式インストーラー](https://docs.astral.sh/uv/getting-started/installation/)でuvを入れ、uvでPythonを入れる。

curl -LsSf https://astral.sh/uv/install.sh | sh

uv python install 3.14

入れたらターミナルを開き直し、`uv --version` でバージョンが表示されるのを確かめる。

Notionの準備

1. [Notionのインテグレーション画面](https://www.notion.so/profile/integrations)で Internal Integration を作り、トークン（`ntn_` で始まる。2024-09-25より前に発行したものは `secret_` で始まる）を控える。

2. 読み書きしたいページやデータベースを開き、右上の「接続」からこのIntegrationを追加する。追加していないページはAPIから見えず、404になる。

3. トークンを、スキルのフォルダの外にあるファイルへ保存する。`ntn_xxxxxxxx` は控えたトークンに置き換える。キーの名前は同梱の `.env.example` と同じ。

   mkdir -p "$HOME/.claude-skills-env"
   echo 'NOTION_TOKEN=ntn_xxxxxxxx' > "$HOME/.claude-skills-env/notion-cli-api-skill.env"

コメントに答えてもらうときの準備

[Notionのコメントに答えてもらう](#notionのコメントに答えてもらう)ときだけ要る。

1. Notionのインテグレーション画面で、Integrationの「Read comments」と「Insert comments」を有効にする。既定はオフで、オフのままだと403になるか、中身の無い結果が返る。
2. 公式の Notion MCP をClaudeに接続す