Velog

velog-mcp-claude

Velog開発者（@velopert）から運営を許可するとの回答を受けた、独立したオープンソースプロジェクトです。

ClaudeがVelogに直接、投稿の作成・公開・編集・削除を行えるほか、コメント・いいね・検索・トレンドにも対応できるMCPサーバーです。

stdioベースの標準MCPサーバーなので、Claude Code、Claude Desktop、Codex CLIなど、MCPに対応するクライアントで動作します。

npm： velog-mcp-claude | 要件：Node.js 18+

インストール

npx -p velog-mcp-claude velog-mcp-setup

Velogにログインした状態で、ブラウザーのDevTools → Application → Cookies → https://velog.ioから、access_tokenとrefresh_tokenの値をコピーして入力してください。

トークンは~/.velog-mcp.jsonに0600の権限で保存されます。

設定

Claude Code

claude mcp add velog -- npx -y velog-mcp-claude

グローバルに追加するには：

claude mcp add --scope global velog -- npx -y velog-mcp-claude

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.jsonに追加：

{
  "mcpServers": {
    "velog": {
      "command": "npx",
      "args": ["-y", "velog-mcp-claude"]
    }
  }
}

Codex CLI

codex mcp add velog -- npx -y velog-mcp-claude

または、~/.codex/config.tomlに直接追加：

[mcp_servers.velog]
command = "npx"
args = ["-y", "velog-mcp-claude"]

登録を確認するにはcodex mcp listを実行します。

ツール一覧

投稿

ツール	説明
velog_draft_post	投稿の下書きを作成
velog_publish_post	下書きをVelogに公開
velog_list_posts	自分の投稿一覧を取得
velog_get_post	特定の投稿の全内容を取得（閲覧数を含む）
velog_update_post	既存の投稿を編集
velog_delete_post	投稿を削除
velog_upload_image	ローカル画像をVelog CDNにアップロード
velog_import_from_github	GitHubブログのMarkdownをVelogの下書きとしてインポート
velog_git_to_post	gitコミット履歴とdiffを分析し、ブログ下書き用のプロンプトを生成

シリーズ

ツール	説明
velog_list_series	自分のシリーズ一覧を取得
velog_create_series	新しいシリーズを作成
velog_update_series	シリーズ名・説明を編集
velog_append_to_series	投稿をシリーズに追加
velog_delete_series	シリーズを削除

コメント

ツール	説明
velog_get_comments	投稿のコメント一覧を取得（返信を含む）
velog_write_comment	コメントまたは返信を投稿
velog_update_comment	コメントを編集
velog_delete_comment	コメントを削除

いいね

ツール	説明
velog_like_post	投稿にいいねする
velog_unlike_post	投稿のいいねを取り消す

探索

ツール	説明
velog_search_posts	キーワードで投稿を検索
velog_get_trending	トレンド投稿を取得（day / week / month / year）
velog_trend_report	トレンド投稿の分析レポート
velog_topic_research	トレンドタグと自分の投稿をクロス分析し、まだ書いていない人気トピックを発掘
velog_get_rss	特定ユーザーのRSSフィードを取得（認証不要）

自分のアカウント

ツール	説明
velog_list_tags	自分のタグ一覧とタグ別の投稿数を取得
velog_list_temp_posts	一時保存した投稿の一覧を取得
velog_get_notifications	通知一覧を取得（いいね・コメント・フォロー、未読件数を含む）
velog_get_reading_list	読書リスト（ブックマーク）を取得

gitコミット → ブログの下書き

最近のコミット履歴とdiffを分析し、Claudeが韓国語の技術ブログ投稿を自動で作成します。

나: "오늘 작업한 커밋들로 벨로그 포스트 작성해줘"
나: "지난 10개 커밋 기반으로 블로그 글 써줘"
나: "v0.19.0 태그 이후 변경사항으로 포스트 초안 만들어줘"

• repo_path：分析するローカルgitリポジトリのパス（デフォルト：現在のディレクトリ）
• commits：取得する直近のコミット数（デフォルト：5）
• since：特定のコミット・タグ以降の範囲を指定（例：v0.19.0、HEAD~10）
• include_diff：コードdiffを含めるかどうか（デフォルト：true）
• max_diff_lines：diffから取得する最大行数（デフォルト：200）
• tags：投稿に含めるタグのヒント（未指定の場合はファイル拡張子から自動推定）

GitHubブログの移行

Jekyll / Hugoなど、front matterを含むMarkdownに対応しています。まずdry_run: trueでプレビューを確認してください。

나: "내 깃허브 블로그 _posts 폴더 글들을 벨로그 초안으로 옮겨줘"

• 相対パスの画像はGitHubのraw URLに自動変換されます
• Privateリポジトリにはgithub_tokenパラメーターでアクセスできます

GitHub APIのレート制限に達した場合

トークンなしで使用すると、1時間あたり60回の制限があります。dry_run: trueを一度実行するだけでも、制限のかなりの部分を消費する場合があります。

制限に達した場合は、github_tokenを発行して渡してください。

トークンの発行：GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token

• 公開リポジトリ：スコープなしで作成してもかまいませんが、public_repoにチェックを入れると確実です
• 非公開リポジトリ：repoにチェック

トークンを渡すと、1時間あたり5,000回に制限が引き上げられます。

認証

• access_token：有効期間は約24時間。Velogサーバーが自動更新します
• refresh_token：有効期間は約30日。期限切れの場合はnpx -p velog-mcp-claude velog-mcp-setupを再実行してください

注意事項

• draftはMCPサーバーのセッションメモリに保存されます。再起動すると消失し、24時間後に自動で期限切れになります。
• 保持するには、velog_publish_post(is_private: true)で非公開として保存してください。

ロードマップ

docs/roadmap.mdを参照してください。

기능 제안

원하는 기능이 있으면 기능 제안 이슈로 남겨 주세요. 먼저 로드맵과 기존 이슈에 같은 제안이 있는지 확인하고, 있으면 👍 반응이나 댓글로 의견을 보태 주세요.

링크로 열면 제목 앞에 [기능 제안]이 붙고 아래 양식이 자동으로 채워집니다. 각 칸을 채워 주시면 검토가 빠릅니다.

## 하고 싶은 일
Claude에게 어떤 요청을 했을 때 무엇이 되길 원하는지
예) "내 시리즈 글 순서를 발행일 순으로 바꿔줘"

## 지금 불편한 점
현재 툴로는 왜 안 되는지, 어떻게 우회하고 있는지

## 참고 (선택)
Velog 웹에서 같은 동작을 하는 화면, 관련 API 요청 등

Velog 비공개 API에 없는 동작이거나 대량 발행·스팸처럼 정상적인 블로그 활동 범위를 벗어나는 기능은 구현하지 않을 수 있습니다.

면책 조항

내부 GraphQL API를 리버스 엔지니어링하여 구현되었습니다. API 구조 변경으로 예고 없이 동작이 중단될 수 있습니다.