Skip to main content
Glama

note.com MCP Server

note.comのAPIを利用して、Claude Desktop、Cursor、n8nなどのMCPクライアントから記事の検索・投稿・分析ができるMCPサーバーです。


🤖 Cursor自動セットアップ(このブランチ専用)

ユーザーが「セットアップして」と言ったら、

.cursorrules には以下が記載されています:

  1. Node.js確認

  2. npm install

  3. Playwright インストール

  4. ビルド

  5. パス取得

  6. OS判定

  7. MCP設定ファイル作成

  8. 動作確認

  9. 完了報告

詳細は


📢 リポジトリ移行のお知らせ(2025年11月)

リポジトリを移行しました。

  • ⚠️ 旧リポジトリ: shimayuz/note-mcp-server (削除済み)

  • 新リポジトリ: shimayuz/note-com-mcp (現在のリポジトリ)

🔄 移行内容

  • 📦 同じ機能: すべてのMCPツールと機能は変更なし

  • 🚀 改善されたセットアップ: より簡単なインストール手順

古いリポジトリは使用しないでください。必ず新しいリポジトリをご利用ください。

🚀 クイックスタート

1. インストール

git clone https://github.com/shimayuz/note-com-mcp.git cd note-com-mcp npm install npx playwright install # ブラウザ自動ログイン用 npm run build

2. 認証設定

方法A: 環境変数で認証情報を設定(推奨)

cp .env.sample .env

.env を編集:

NOTE_EMAIL=your-email@example.com NOTE_PASSWORD=your-password # 以下はオプション(自動取得される) NOTE_SESSION_V5=取得したセッションCookie NOTE_XSRF_TOKEN=取得したXSRFトークン NOTE_USER_ID=あなたのユーザーID

メリット:

  • MCPクライアント(Claude Desktop/Cursor/n8n)からバックグラウンドで起動可能

  • セッション切れ時に自動再ログイン

  • リモートサーバー(VPS/Docker)でも動作

セキュリティ: .envファイルは.gitignoreに含まれているため、リポジトリにコミットされません。

方法B: 初回起動時に手動ログイン(開発・デバッグ用)

認証情報なしで起動すると、Playwrightがブラウザを開きます。

npm run start
  1. Chromiumブラウザが自動で開く

  2. note.comのログインページが表示される

  3. 手動でメールアドレスとパスワードを入力してログイン

  4. ログイン完了を検知し、セッション情報を自動取得

  5. ブラウザが自動で閉じる

  6. MCPサーバーが起動完了

注意: この方法はローカル開発時のみ使用してください。リモートサーバーやヘッドレス環境では動作しません。

3. 起動

ローカル利用(Claude Desktop/Cursor):

npm run start

リモート利用(n8n/HTTP経由):

npm run start:http # ポート3000が使用中の場合: MCP_HTTP_PORT=3001 npm run start:http

✨ 主な機能

カテゴリ

機能

認証

🔍 検索

記事検索、ユーザー検索、ハッシュタグ検索

不要

📊 分析

記事分析、エンゲージメント分析

不要

✍️ 投稿

下書き作成、画像付き投稿

必須

🖼️ 画像

画像アップロード、アイキャッチ設定

必須

💬 コメント

コメント投稿、スキ機能

必須

📈 統計

PV数、アクセス解析

必須

📋 利用可能なツール

検索・分析(認証不要)

  • search-notes - 記事検索(新着/人気/急上昇)

  • search-all - note全体検索

  • analyze-notes - 記事詳細分析

  • get-note - 記事詳細取得

  • search-users - ユーザー検索

  • get-user - ユーザー情報取得

  • search-magazines - マガジン検索

投稿・編集(認証必須)

  • post-draft-note - 下書き作成

  • post-draft-note-with-images - 画像付き下書き作成

  • upload-image - 画像アップロード

  • upload-images-batch - 複数画像アップロード

  • get-my-notes - 自分の記事一覧

インタラクション(認証必須)

  • post-comment - コメント投稿

  • like-note / unlike-note - スキ機能

  • get-stats - PV統計情報

🔧 設定方法

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加

{ "mcpServers": { "note-api": { "command": "node", "args": ["/path/to/note-com-mcp/build/note-mcp-server.js"], "env": { "NOTE_EMAIL": "your_email@example.com", "NOTE_PASSWORD": "your_password", "NOTE_USER_ID": "your_note_user_id" } } } }

Cursor

~/.cursor/mcp.json に以下を追加

{ "mcpServers": { "note-api": { "command": "node", "args": ["/path/to/note-com-mcp/build/note-mcp-server.js"], "env": { "NOTE_EMAIL": "your_email@example.com", "NOTE_PASSWORD": "your_password", "NOTE_USER_ID": "your_note_user_id" } } } }

Windsurf

~/.codeium/windsurf/mcp_config.json に以下を追加

{ "mcpServers": { "note-api": { "command": "node", "args": ["/path/to/note-com-mcp/build/note-mcp-server.js"], "env": { "NOTE_EMAIL": "your_email@example.com", "NOTE_PASSWORD": "your_password", "NOTE_USER_ID": "your_note_user_id" } } } }

重要: /path/to/note-com-mcp は、実際のプロジェクトの絶対パスに置き換えてください。例:/Users/username/note-com-mcp

n8n(HTTP経由)

  1. HTTPサーバーを起動

npm run start:http
  1. n8nで「MCP Client HTTP Streamable」ノードを設定

HTTP Stream URL: http://127.0.0.1:3000/mcp HTTP Connection Timeout: 60000

🌐 リモートアクセス(Cloudflare Tunnel)

VPSでn8nを使用する場合、Cloudflare Tunnelで安全に接続できます:

# 1. Cloudflare Tunnelを設定 cloudflared tunnel run note-mcp # 2. n8nでHTTPS URLを設定 # HTTPS Stream URL: https://your-domain.com/mcp

📝 Markdown変換ルール

投稿時のMarkdownは自動的にnote.com用HTMLに変換されます。

Markdown

note.com

HTML

# H1 / ## H2

大見出し

<h2>

### H3

小見出し

<h3>

#### H4-H6

太字

<strong>

![[image.png]]

画像

<figure><img>

- リスト

箇条書き

<ul><li>

💡 使い方の例

記事検索(認証不要)

noteで「プログラミング」に関する人気記事を検索して

画像付き投稿(認証必須)

タイトル「技術メモ」、本文「## 概要\n\n![[screenshot.png]]」で下書きを作成して

記事分析(認証不要)

ユーザー「username」の記事を分析して、人気の要因を教えて

⚠️ 注意点

  • 投稿機能: 下書き作成のみ対応です。公開はnote.comから直接投稿してください

  • 画像: サポート形式はPNG、JPEG、GIFです(最大10MB)

  • 検索結果: 最大20件まで取得できます

  • 認証: Cookieの有効期限(約1〜2週間)切れで再設定が必要です

🛠️ 開発

# 開発モード(ファイル監視) npm run dev:watch # HTTPサーバー開発 npm run dev:http # TypeScript直接実行 npm run dev:ts

📄 ライセンス

MIT License

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shimayuz/note-com-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server