note.com MCP Server
このMCPサーバーは、note.comのAPIを利用して記事の閲覧や投稿、ユーザー情報の取得などをClaude Desktopから実行できるようにするものです。
機能
このMCPサーバーでは以下の機能が利用できます：
- 記事の検索と閲覧
- ユーザーの検索とプロフィール閲覧
- 記事の投稿（下書き）
- コメントの閲覧と投稿
- スキの管理（取得・追加・削除）
- マガジンの検索と閲覧
- カテゴリー記事の閲覧
- PV統計情報の取得
- コンテンツアイデアの生成と競合分析
認証について
このサーバーでは、ほとんどの読み取り機能（記事検索、ユーザー情報など）は 認証なしで利用できます 。一方、以下の機能を使用するには note.comの認証情報 が必要です：
- 記事投稿（下書き）
- コメント投稿
- スキをつける/削除する
- PV統計情報の取得
セットアップ
必要なもの
- Node.js (v18以上)
- npm または yarn
- Claude Desktop
- note.comのアカウント（投稿機能を使う場合）
インストール手順
このリポジトリをクローンまたはダウンロードする
git clone https://github.com/yourusername/note-mcp-server.git
cd note-mcp-server
依存パッケージをインストール
npm install
ソースファイルをsrcディレクトリに移動（既にsrcディレクトリにある場合は不要）
mkdir -p src
mv note-mcp-server.ts src/
.env.exampleファイルをコピーして.envファイルを作成
cp .env.example .env
必要に応じて、.envファイルを編集して認証情報を設定（後述）
TypeScriptをビルド
npm run build
認証情報の取得方法
投稿やスキなどの機能を使うには、以下の手順でCookieを取得してください：
- ブラウザでnote.comにログインする
- ブラウザの開発者ツール（F12）を開く
- アプリケーションタブ（Application）を選択
- 左側のメニューからCookies→「https://note.com」を選択
- 以下のCookie値をコピーして
.envファイルに設定：
* note_gql_auth_token
* _note_session_v5（先頭のアンダースコアに注意）
注意 : どちらか一方のCookieだけでも多くの認証機能は動作しますが、両方設定するとより安定します。
Claude Desktopとの連携
Claude Desktopをインストールして起動
Claude Desktopの設定ファイルを開く:
* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- 設定ファイルに以下の内容を追加（パスは実際のパスに変更してください）:
{
"mcpServers": {
"note-api": {
"command": "node",
"args": [
"/Users/heavenlykiss0820/noteMCP/build/note-mcp-server.js"
],
"env": {
"NOTE_GQL_AUTH_TOKEN": "あなたのトークン",
"NOTE_SESSION_V5": "あなたのセッションv5トークン"
}
}
}
}
認証が不要な場合（検索・閲覧のみ）は、env部分は省略できます：
{
"mcpServers": {
"note-api": {
"command": "node",
"args": [
"/Users/heavenlykiss0820/noteMCP/build/note-mcp-server.js"
]
}
}
}
- Claude Desktopを再起動
使い方
以下のようなクエリをClaude Desktopで試すことができます：
- 「noteで『プログラミング』に関する人気記事を検索して」
- 「ユーザー『username』の記事を分析して、人気の要因を教えて」
- 「マーケティングについての記事のアイデアを5つ考えて」
- 「プログラミングに関する記事を書きたいので、アウトラインを考えて」
認証ありの場合のみ使える機能：
- 「私のnoteアカウントの最新記事のPV数を教えて」
- 「この記事にスキをつけて」
- 「この記事にコメントを投稿して」
利用可能なツール
このMCPサーバーでは以下のツールが利用できます：
記事関連（認証なしで利用可能）
- search-notes : キーワードで記事を検索
- get-note : 記事IDから詳細情報を取得
- get-category-notes : カテゴリーの記事一覧を取得
ユーザー関連（認証なしで利用可能）
- search-users : ユーザーを検索
- get-user : ユーザー詳細情報を取得
- get-user-notes : ユーザーの記事一覧を取得
マガジン関連（認証なしで利用可能）
- search-magazines : マガジンを検索
- get-magazine : マガジンの詳細を取得
インタラクション（認証必須）
- post-draft-note : 下書き記事を投稿
- get-comments : 記事のコメント一覧を取得（認証なしでも可能なケースあり）
- post-comment : 記事にコメントを投稿
- get-likes : 記事のスキ一覧を取得（認証なしでも可能なケースあり）
- like-note : 記事にスキをつける
- unlike-note : 記事のスキを削除
統計（認証必須）
プロンプトテンプレート
このサーバーには以下のプロンプトテンプレートも含まれています：
- note-search : noteでキーワード検索し記事を要約
- competitor-analysis : 競合ユーザーの分析
- content-idea-generation : 指定トピックの記事アイデア生成
- article-analysis : 指定記事の文章や構成の分析
トラブルシューティング
サーバーが起動しない
.envファイルが正しく設定されているか確認- Node.jsのバージョンが18以上か確認（
node -vコマンドで確認）
- 依存パッケージがインストールされているか確認（
npm installを実行）
npm run buildでTypeScriptがビルドできているか確認
認証エラーが発生する
- Cookie値が最新か確認（期限が切れている可能性あり）
- 両方のCookie値（
note_gql_auth_tokenと_note_session_v5）を設定してみる
- 認証が必要な機能か確認
APIエラーが発生する
- note.comの仕様変更の可能性があります
- 最新版のサーバーを入手するか、エラーが発生した部分のコードを確認・修正してください
注意事項
- このサーバーはnote.comの非公式APIを利用しています
- APIの仕様変更により、一部または全部の機能が動作しなくなる可能性があります
- Cookie認証は有効期限があるため、定期的に更新が必要です
- note.comの利用規約を遵守して使用してください
ライセンス
MIT
