# Tistory MCP (Unofficial)

> Tistory MCP (Unofficial) is a free MCP server for news and media. Unofficial MCP server to write, edit and manage Tistory blog posts, private by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/jangsejong/tistory-mcp
- **MCP Registry name:** io.github.jangsejong/tistory-mcp
- **Categories:** [news and media](https://ai-powered.com/categories/news-and-media)
- **Listing updated:** 2026-11-18

## About

Tistory's open API was shut down in February 2024, so this project works differently: after you log in once through a browser with Kakao and approve the push on your phone, it stores the session cookies on your machine and calls the internal JSON API that Tistory's admin pages use. It is not affiliated with Kakao or Tistory and can stop working whenever Tistory changes its internals. Session lifetimes also vary; the author measured one that ended after about an hour.

Its safety model is the notable part. New posts are published as private unless a call explicitly asks for public, deletion is refused without confirm=true, publish and update calls are limited to one per 60 seconds and 20 per day by default, only *.tistory.com hosts are accepted unless you opt in, and post HTML is sanitized with nh3. Publish never retries automatically, because each call creates a new post.

Eleven tools cover converting Markdown to Tistory editor HTML, publishing, editing, deleting, listing categories and posts including private ones, uploading images, saving drafts to the editor autosave slot, and reading any blog's public RSS without login. Install through uvx or pipx; cookies live in a 0600 file or the OS keyring.

## Features

- **Private by default:** Posts publish as private unless the call explicitly asks for public.
- **Markdown to editor HTML:** Converts Markdown into Tistory editor formatting.
- **Image upload:** Returns placeholders so images do not break later.
- **Draft saving:** Stores drafts in the editor's autosave slot.
- **Rate limits:** One publish or update per 60 seconds and 20 a day by default.
- **Public RSS reading:** Reads any Tistory blog's public posts without login.

## Good for

- Draft a blog post with an AI assistant and review it before going public
- Edit or tidy older posts in bulk
- Upload images for a post
- List posts, including private ones, and their categories
- Pull recent public posts from a blog's RSS

## Install

### Claude Code (Terminal)

```sh
claude mcp add tistory-mcp -- uvx tistory-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tistory-mcp": {
      "command": "uvx",
      "args": [
        "tistory-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tistory-mcp": {
      "command": "uvx",
      "args": [
        "tistory-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tistory-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tistory-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tistory-mcp": {
      "command": "uvx",
      "args": [
        "tistory-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tistory-mcp": {
      "command": "uvx",
      "args": [
        "tistory-mcp"
      ]
    }
  }
}
```

## Tools

- `tistory_session_init`: Opens a browser for Kakao login and stores the blog session.
- `tistory_publish_post`: Publishes a new post, private by default.
- `tistory_upload_image`: Uploads an image and returns the placeholder to use in the post body.
- `tistory_fetch_public_posts`: Reads a blog's public posts without login.

## FAQ

### Is this official?

No. It is unofficial and unrelated to Kakao or Tistory.

### How does login work?

You sign in with Kakao in a browser and approve the push yourself; the cookies are then stored locally.

### Where are credentials stored?

In a 0600 file under the config directory, or the OS keyring.

### Can it delete posts?

Only with confirm=true on the call.

### How do I install it?

Run it with uvx tistory-mcp, or install with pipx.

### Is Tistory MCP (Unofficial) free?

Yes. Tistory MCP (Unofficial) is free to use.

### How do I add Tistory MCP (Unofficial) to Claude Code?

Run this command in your terminal: claude mcp add tistory-mcp -- uvx tistory-mcp

### What are the best alternatives to Tistory MCP (Unofficial)?

The closest alternatives to Tistory MCP (Unofficial) are TrendRadar, Design Feeds, Crypto Feeds, Finance Feeds and Fyyd.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Finance Feeds](https://ai-powered.com/mcp/finance-feeds): Finance Feeds is a freemium MCP server for finance and payments.
- [Fyyd](https://ai-powered.com/mcp/fyyd): Fyyd is a freemium MCP server for news and media.
- [Science Feeds](https://ai-powered.com/mcp/science-feeds): Science Feeds is a freemium MCP server for news and media.
- [Health Feeds](https://ai-powered.com/mcp/health-feeds): Health Feeds is a freemium MCP server for health and science.
- [Gaming Feeds](https://ai-powered.com/mcp/gaming-feeds): Gaming Feeds is a freemium MCP server for news and media.

---
Source: https://ai-powered.com/mcp/tistory-mcp-unofficial
