Skip to main content
Glama

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_setup

While 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_mcp

Or 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_mcp

Global settings are available in all projects.

Verification

claude mcp list

If 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

velog_draft_post

Create a post draft (stored in session memory)

velog_publish_post

Publish a draft to Velog

velog_list_posts

View a list of your posts

velog_get_post

View the full content of a specific post

velog_update_post

Update an existing post

velog_delete_post

Delete a post

Authentication

  • access_token: ~1-2 hour TTL. The Velog server automatically refreshes it via Set-Cookie in GraphQL responses.

  • refresh_token: ~30 day TTL. If it expires, you must re-run npx 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 (![alt](url)).

License

MIT

Install Server
A
license - permissive license
A
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

View all related MCP servers

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.

View all MCP Connectors

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/seongwon030/velog_mcp'

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