The note.com MCP Server provides comprehensive access to note.com's API through Claude Desktop, Cursor, n8n, and similar clients, enabling search, analysis, and content management both with and without authentication.
Search and Discovery (No Authentication Required):
Search articles, users, magazines, and hashtags with customizable parameters including sorting (new/popular/trending) and pagination
Perform unified searches across notes, users, and hashtags
Analyze articles with detailed competitive analysis, content characteristics, and author information
Retrieve specific article, user, magazine, and hashtag details
Browse categories and get articles by category
Access lists of categories, hashtags, contests, and search history
Content Management (Authentication Required):
Create draft articles with titles, body text, and tags (up to 10 tags), with automatic Markdown to HTML conversion
Upload single or multiple images (PNG, JPEG, GIF up to 10MB)
Retrieve and manage your articles, including drafts and published notes with status filtering
Add or remove articles from magazines
Open the note editor for existing articles
Social Interactions (Authentication Required):
Post comments and view comments on articles
Like/unlike articles and retrieve like counts
Analytics and Statistics (Authentication Required):
Access PV (Page View) statistics and dashboard analytics with sorting and filtering options
Track engagement metrics and notification counts
Membership Features (Authentication Required):
View membership summaries, plans, and associated articles
Access circle information and membership content
Integration and Setup:
Configure locally with Claude Desktop, Cursor, or Windsurf via JSON configuration
Run as HTTP server for remote access with n8n, with support for Cloudflare Tunnel
Install via npm with environment variables for authentication (email, password, or session cookies)
Key Limitations:
Posts are created as drafts only; publishing requires manual action on note.com
Search results capped at 20 items
Session cookies valid for 1–2 weeks, requiring periodic reconfiguration
Enables secure remote access to the MCP server using Cloudflare Tunnel, allowing connections from remote services like n8n while keeping authentication credentials local
Provides HTTP/SSE transport integration for workflow automation, enabling remote access to note.com functionality through n8n's MCP Client HTTP Streamable node
Supports integration with ChatGPT and OpenAI Responses API through HTTP/SSE transport, allowing AI agents to access note.com article search, user information, and content management capabilities
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@note.com MCP Serversearch for popular articles about AI programming"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
note.com MCP Server
note.comのAPIを利用して、Claude Desktop、Cursor、n8nなどのMCPクライアントから記事の検索・投稿・分析ができるMCPサーバーです。
🤖 Cursor自動セットアップ(このブランチ専用)
ユーザーが「セットアップして」と言ったら、
.cursorrules には以下が記載されています:
Node.js確認
npm install
Playwright インストール
ビルド
パス取得
OS判定
MCP設定ファイル作成
動作確認
完了報告
詳細は
📢 リポジトリ移行のお知らせ(2025年11月)
リポジトリを移行しました。
⚠️ 旧リポジトリ:
shimayuz/note-mcp-server(削除済み)✅ 新リポジトリ:
shimayuz/note-com-mcp(現在のリポジトリ)
🔄 移行内容
📦 同じ機能: すべてのMCPツールと機能は変更なし
🚀 改善されたセットアップ: より簡単なインストール手順
古いリポジトリは使用しないでください。必ず新しいリポジトリをご利用ください。
🚀 クイックスタート
1. インストール
2. 認証設定
方法A: 環境変数で認証情報を設定(推奨)
.env を編集:
メリット:
MCPクライアント(Claude Desktop/Cursor/n8n)からバックグラウンドで起動可能
セッション切れ時に自動再ログイン
リモートサーバー(VPS/Docker)でも動作
セキュリティ: .envファイルは.gitignoreに含まれているため、リポジトリにコミットされません。
方法B: 初回起動時に手動ログイン(開発・デバッグ用)
認証情報なしで起動すると、Playwrightがブラウザを開きます。
Chromiumブラウザが自動で開く
note.comのログインページが表示される
手動でメールアドレスとパスワードを入力してログイン
ログイン完了を検知し、セッション情報を自動取得
ブラウザが自動で閉じる
MCPサーバーが起動完了
注意: この方法はローカル開発時のみ使用してください。リモートサーバーやヘッドレス環境では動作しません。
3. 起動
ローカル利用(Claude Desktop/Cursor):
リモート利用(n8n/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 に以下を追加
Cursor
~/.cursor/mcp.json に以下を追加
Windsurf
~/.codeium/windsurf/mcp_config.json に以下を追加
重要: /path/to/note-com-mcp は、実際のプロジェクトの絶対パスに置き換えてください。例:/Users/username/note-com-mcp
n8n(HTTP経由)
HTTPサーバーを起動
n8nで「MCP Client HTTP Streamable」ノードを設定
🌐 リモートアクセス(Cloudflare Tunnel)
VPSでn8nを使用する場合、Cloudflare Tunnelで安全に接続できます:
📝 Markdown変換ルール
投稿時のMarkdownは自動的にnote.com用HTMLに変換されます。
Markdown | note.com | HTML |
| 大見出し |
|
| 小見出し |
|
| 太字 |
|
| 画像 |
|
| 箇条書き |
|
💡 使い方の例
記事検索(認証不要)
画像付き投稿(認証必須)
記事分析(認証不要)
⚠️ 注意点
投稿機能: 下書き作成のみ対応です。公開はnote.comから直接投稿してください
画像: サポート形式はPNG、JPEG、GIFです(最大10MB)
検索結果: 最大20件まで取得できます
認証: Cookieの有効期限(約1〜2週間)切れで再設定が必要です
🛠️ 開発
📄 ライセンス
MIT License