note-draft-mcp

Claude などの MCP クライアントから、自分の note.com アカウントに記事を「下書き保存」する MCP サーバーです（stdio）。

Markdown を note のエディタ用の HTML に変換し、ローカル画像のアップロード、見出し画像の設定までを行います。

ツール

create_draft / update_draft の引数:

• title: 省略すると、Markdown の先頭にある # 見出し をタイトルにし、本文からは除きます。

• markdown または markdown_path: どちらか一方を指定します。

• base_dir: 画像の相対パスの基準です。省略時は markdown_path のあるディレクトリになります。

• eyecatch_path: 見出し画像のファイルです。

• dry_run: 送信前に内容を確認するためのフラグです。タイトル、本文 HTML の先頭、画像の数、警告を返します。

画像は PNG / JPEG / GIF で、10MB までです。

Related MCP server: note.com MCP Server

必要なもの

• Node.js 20 以上

• note.com にログインしたブラウザ（Cookie を取り出すため）

インストール

git clone https://github.com/goodnasubi/note-mcp.git
cd note-mcp
npm ci
npm run build

Cookie の取得と扱い

1. ブラウザで note.com にログインします。

2. 開発者ツールを開きます（F12）。Chrome では「Application」→「Cookies」→ https://note.com を選びます。

3. _note_session_v5 の 値 をコピーします。

4. 環境変数 NOTE_SESSION_COOKIE に設定します。

export NOTE_SESSION_COOKIE='コピーした値'

NOTE_SESSION_COOKIE には、Cookie ヘッダー全体（_note_session_v5=...; XSRF-TOKEN=...）も入れられます。XSRF-TOKEN が含まれていれば、X-XSRF-TOKEN ヘッダーとして自動で送ります。別に指定したい場合は NOTE_XSRF_TOKEN を使ってください。

MCP クライアントへの登録

Claude Code

Cookie を設定ファイルに書かずに済むよう、シェルの環境変数から渡す方法をおすすめします。

export NOTE_SESSION_COOKIE='...'   # シェルの設定や direnv などで設定しておく
claude mcp add note-draft -- node /path/to/note-mcp/dist/index.js

-e で渡すこともできますが、その場合は Cookie が Claude Code の設定ファイルに保存されます。

claude mcp add note-draft -e NOTE_SESSION_COOKIE='...' -- node /path/to/note-mcp/dist/index.js

Claude Code on the web（クラウドセッション）

1. 環境設定のシークレットに NOTE_SESSION_COOKIE を登録します。

2. ネットワークの許可リストに note.com、editor.note.com、画像の配信・アップロード先（assets.st-note.com と、画像アップロード時に使うストレージのホスト）を追加します。

Claude Desktop

claude_desktop_config.json に追加します。Cookie は設定ファイルに平文で保存されるので、ファイルの扱いに注意してください。

{
  "mcpServers": {
    "note-draft": {
      "command": "node",
      "args": ["/path/to/note-mcp/dist/index.js"],
      "env": { "NOTE_SESSION_COOKIE": "..." }
    }
  }
}

使い方の例

Claude に、たとえば次のように頼みます。

docs/articles/2026-09-26-example.md を、見出し画像 docs/articles/images/header.png で note に下書き保存して。先に dry_run で確認して。

返ってきた edit_url を開いて内容を確認し、問題がなければ note の画面から公開します。

Markdown の変換

使っている API（非公式）

呼べる API は src/note-client.ts の ALLOWED_ENDPOINTS に限定しています。

エンドポイントは、次の MIT ライセンスの実装を参考に調べました。

• TaisukeAndo/note-mcp

• shimayuz/note-com-mcp

開発

npm test          # 単体テスト・結合テスト（HTTP はモック。note には接続しない）
npm run typecheck
npm run build

ライセンス

MIT