velog_mcp
The velog_mcp server enables Claude to comprehensively manage a Velog blog:
Post Management
Create drafts (
velog_draft_post), publish them (velog_publish_post), list posts (velog_list_posts), retrieve full post content by URL slug (velog_get_post), update posts (velog_update_post), and delete posts (velog_delete_post).Upload local images to Velog's CDN (
velog_upload_image).
Git & GitHub Integration
Generate blog draft prompts from recent git commit history and diffs (
velog_git_to_post).Import markdown posts from GitHub repositories (Jekyll/Hugo, including private repos) into Velog drafts with automatic image URL conversion (
velog_import_from_github).
Series Management
List, create, update, and delete series; append posts to a series.
Comments & Likes
Read, write, update, and delete comments/replies.
Like or unlike posts.
Discovery & Trending
Search posts by keyword (
velog_search_posts).Retrieve trending posts by period (day/week/month/year), generate trend reports, and research popular unused topics via cross-analysis of trending tags with personal posts.
Authentication: All authorized operations use Velog access and refresh tokens.
Uses GraphQL reverse engineering to interact with Velog's non-public API, enabling programmatic access to Velog's blogging platform through GraphQL queries and mutations.
Provides tools for creating, publishing, updating, and managing blog posts on Velog, including draft creation with human review workflow, private/public publishing, and post management operations.
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., "@velog_mcpdraft a post about React Server Components best practices"
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.
velog_mcp
An MCP server that allows Claude to directly write and publish posts on Velog.
It supports Velog, which lacks a public API, through GraphQL reverse engineering. Designed with a human-in-the-loop flow of draft → user review → publish, it maintains full user control while automating content creation.
Installation
npx velog_mcp_setupWhile logged into Velog, copy the access_token and refresh_token values from your browser's DevTools → Application → Cookies → https://velog.io.
The tokens will be saved to ~/.velog-mcp.json with 0600 permissions. Please add it to your .gitignore.
Related MCP server: velog-mcp
Claude CLI (Claude Code) Setup
Add to Project
claude mcp add velog npx -y velog_mcpOr add it directly to your project's .claude/settings.json:
{
"mcpServers": {
"velog": {
"command": "npx",
"args": ["-y", "velog_mcp"]
}
}
}Add Globally
claude mcp add --scope global velog npx -y velog_mcpGlobal settings are available in all projects.
Verification
claude mcp listIf the velog server appears in the list, you are ready. You can use it directly in Claude Code conversations.
나: "React 훅에 대한 글 써줘"
Claude: (velog_draft_post 호출 → 검토 후 발행)Claude Desktop Setup
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"velog": {
"command": "npx",
"args": ["-y", "velog_mcp"]
}
}
}Usage
Writing and Publishing Posts
나: "React 19 concurrent features에 대한 글 써줘"
Claude: velog_draft_post 호출
→ { draft_id: "abc123", title: "React 19 Concurrent Features 정리", body_preview: "..." }
나: "좋아, 발행해"
Claude: velog_publish_post(draft_id: "abc123") 호출
→ { url: "https://velog.io/@username/react-19-...", post_id: "..." }Private Publishing
나: "이 글 비공개로 발행해줘"
Claude: velog_publish_post(draft_id: "abc123", is_private: true)Tool List
Tool | Description |
| Create a post draft (stored in session memory) |
| Publish a draft to Velog |
| View a list of your posts |
| View the full content of a specific post |
| Update an existing post |
| Delete a post |
Authentication
access_token: ~1-2 hour TTL. The Velog server automatically refreshes it viaSet-Cookiein GraphQL responses.refresh_token: ~30 day TTL. If it expires, you must re-runnpx velog_mcp_setup.No separate refresh endpoint — handled automatically by Velog middleware.
Error Handling
Situation | Message |
Token expired (401) | "The token has expired or is invalid. Please re-run npx velog_mcp_setup." |
No config file | "Configuration file not found. Please run npx velog_mcp_setup." |
Network error | "Cannot connect to Velog API. Please check your network." |
Invalid draft_id | "draft_id does not exist. Please call velog_draft_post first." |
GraphQL error | Returns the Velog server error message as is |
Precautions
Drafts are stored in the session memory of the MCP server process. They are lost when Claude Desktop is restarted.
To save without publishing, use
velog_publish_post(is_private: true)to save as private.Images: Use the markdown external URL reference method (
).
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityBmaintenanceConnects Claude to WordPress sites through the REST API, enabling AI-assisted content creation, publishing, media management, user administration, and site maintenance tasks through natural language.472222MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to read, search, and write Velog blog posts. Supports post management, trending, and series/profile retrieval.10117MIT
- Flicense-qualityDmaintenanceEnables creating draft posts and listing published posts on abelcastro.dev directly from Claude.
- Flicense-qualityDmaintenanceMulti-platform blog publishing tool that enables users to save, schedule, and publish SEO-optimized articles to platforms like websites, LinkedIn, Twitter, and Substack directly from Claude.
Related MCP Connectors
Live SEO workflow tools for Claude Code, Codex, and AI agents.
Read, edit, publish, and preview your pepita websites from Claude.
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/seongwon030/velog_mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server