# Velog [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/seongwon030/velog_mcp  
**GitHub Stars:** 7  
**npm Downloads (last month):** 1119  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/velog-2

## Description
Write, publish, and manage Velog (velog.io) posts, series, comments, and trends. 29 tools.

## Tools
Capabilities this server exposes over MCP:

- **velog_draft_post** — Velog 포스트 초안을 세션 메모리에 저장합니다. 발행 전 사용자가 검토할 수 있도록 draft_id를 반환합니다.
- **velog_publish_post** — 초안(draft_id)을 Velog에 발행합니다. velog_draft_post 호출 후 사용하세요.
- **velog_list_posts** — Velog 포스트 목록을 가져옵니다. username을 지정하면 타 유저 포스트도 조회할 수 있습니다.
- **velog_get_post** — 특정 Velog 포스트의 전체 내용을 가져옵니다. username을 지정하면 타 유저 포스트도 조회할 수 있습니다.
- **velog_update_post** — 기존 Velog 포스트를 수정합니다.
- **velog_delete_post** — Velog 포스트를 삭제합니다.
- **velog_upload_image** — 로컬 이미지 파일을 Velog에 업로드하고 URL을 반환합니다. 반환된 URL을 마크다운 본문에 사용하세요.
- **velog_write_comment** — Velog 포스트에 댓글을 작성합니다. comment_id를 지정하면 대댓글로 작성됩니다.
- **velog_delete_comment** — Velog 댓글을 삭제합니다.
- **velog_update_comment** — Velog 댓글 내용을 수정합니다.
- **velog_get_comments** — 특정 Velog 포스트의 댓글 목록을 가져옵니다. 댓글 ID를 확인하여 삭제에 활용할 수 있습니다. username을 지정하면 타 유저 포스트의 댓글도 조회할 수 있습니다.
- **velog_like_post** — Velog 포스트에 좋아요를 누릅니다.
- **velog_unlike_post** — Velog 포스트 좋아요를 취소합니다.
- **velog_search_posts** — Velog 포스트를 키워드로 검색합니다. username을 지정하면 특정 유저의 포스트만 검색합니다.
- **velog_get_trending** — Velog 트렌딩 포스트 목록을 가져옵니다. timeframe으로 기간을 지정할 수 있습니다.
- **velog_trend_report** — Velog 트렌딩 포스트를 분석하여 최근 개발 동향 리포트 데이터를 반환합니다. 각 포스트의 태그, 요약, 좋아요/댓글 수를 포함하며 Claude가 이를 분석해 트렌드 문서를 작성합니다.
- **velog_get_notifications** — 내 Velog 알림 목록을 가져옵니다. 좋아요·댓글·팔로우 알림과 읽지 않은 알림 수를 반환합니다.
- **velog_get_reading_list** — 내 Velog 읽을 목록(북마크)을 가져옵니다. 저장한 포스트 목록을 반환합니다.
- **velog_get_rss** — 특정 Velog 유저의 RSS 피드를 가져옵니다. 인증 없이 최신 포스트 목록을 조회할 수 있습니다.
- **velog_list_tags** — 내 Velog 태그 목록과 태그별 포스트 수를 조회합니다.
- **velog_list_temp_posts** — Velog 임시저장 포스트 목록을 가져옵니다.
- **velog_list_series** — 내 Velog 시리즈 목록을 조회합니다.
- **velog_create_series** — 새 Velog 시리즈를 생성합니다.
- **velog_update_series** — Velog 시리즈의 이름 또는 URL slug를 수정합니다.
- **velog_append_to_series** — 포스트를 시리즈에 추가합니다. post_id는 velog_publish_post 또는 velog_list_posts 응답에서 확인할 수 있습니다.
- **velog_delete_series** — Velog 시리즈를 삭제합니다. 시리즈 내 포스트는 삭제되지 않습니다.
- **velog_topic_research** — Velog 트렌딩 포스트를 분석해 내가 아직 쓰지 않은 인기 주제(gap)를 찾아줍니다. 트렌딩 태그 빈도와 내 포스트 태그 이력을 교차분석해 주제 발굴에 활용하세요.
- **velog_import_from_github** — GitHub 블로그 저장소의 마크다운 파일을 Velog 초안으로 가져옵니다. Jekyll/Hugo/기타 정적 블로그의 _posts 폴더를 지원합니다. dry_run: true로 먼저 미리보기를 확인하세요.
- **velog_git_to_post** — git 커밋 이력과 diff를 분석해 Velog 블로그 초안용 컨텍스트를 반환합니다. 코딩 후 '오늘 작업한 거 블로그에 올려줘'라고 하면 자동으로 커밋 내역과 변경 코드를 수집해 Claude가 초안을 작성할 수 있도록 합니다.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What Velog MCP server does

Velog MCP server exposes Velog account and content operations through MCP. It can create a post draft, return a draft ID for review, and publish that draft as public or private content. Existing posts can be listed, read, updated, or deleted, and local images can be uploaded for use as Markdown URLs.

The server also covers community and discovery workflows. Agents can read, write, edit, and delete comments, including replies; like or unlike posts; search posts; inspect notifications and unread counts; and retrieve a user's reading list. RSS retrieval for a Velog user is available without authentication.

Series can be created, renamed, assigned a new URL slug, populated with posts, or deleted without deleting the posts inside them. Tag counts and temporary saved posts are also available for account maintenance.

## How it works

The server runs as an MCP process and is intended for MCP-compatible clients. Authentication uses Velog's `access_token` and `refresh_token` values, which are obtained from Velog cookies in a browser. Public RSS access is an exception and does not require authentication.

A typical publishing flow starts with `velog_draft_post`, which stores the draft in session memory and returns a `draft_id`. The client can present the draft for review before calling `velog_publish_post`. Operations that publish or delete content should be reviewed before confirmation because they can be difficult to reverse.

Trend tools retrieve trending posts for a selected period, summarize tags and engagement data, and provide inputs for development-trend reports. Topic research compares trending tag frequency with the user's post-tag history to identify popular subjects that have not yet been covered.

## Setup and configuration

Node.js 18 or newer is required. Install the authentication helper with:

```bash
npx -p velog-mcp-claude velog-mcp-setup
```

The helper stores the Velog tokens taken from the `velog.io` cookies named `access_token` and `refresh_token`. Register the server with an MCP client using the npm package:

```bash
claude mcp add velog -- npx -y velog-mcp-claude
```

The package is designed for clients such as Claude Code, Claude Desktop, and Codex CLI. Its implementation relies on Velog's internal GraphQL API, so changes to that API may interrupt functionality without advance notice.

## Tools and capabilities

- Create, review, publish, update, and delete Velog posts.
- Upload local images and use returned URLs in Markdown.
- List, read, search, and retrieve RSS content from Velog users.
- Manage comments, replies, likes, notifications, bookmarks, tags, and temporary posts.
- Create and maintain series, then append posts to them.
- Analyze trending posts and find uncovered topic opportunities.
- Import Markdown from GitHub blog repositories into Velog drafts. The importer supports `_posts` directories from Jekyll, Hugo, and other static-blog layouts, with a dry-run preview option.
- Inspect git commits and diffs to produce context for a blog draft based on recent coding work.

## Limitations and notes

Velog authentication requires browser cookie tokens, and authenticated account operations depend on those tokens remaining valid. The server uses a reverse-engineered internal GraphQL API, which may change and cause unexpected interruptions. Publishing publicly and deleting posts or other content are consequential actions; inspect the content and approve the operation before allowing the client to proceed.

_Full upstream README: https://allmcps.com/mcp/velog-2/readme_