Tistory MCP (Unofficial)
Unofficial MCP server to write, edit and manage Tistory blog posts, private by default
- Pricing
- Free
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- today
Similar MCP servers
About Tistory MCP (Unofficial)
Tistory MCP (Unofficial) is a free MCP server for news and media. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add tistory-mcp -- uvx tistory-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tistory-mcp": {
"command": "uvx",
"args": [
"tistory-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tistory-mcp": {
"command": "uvx",
"args": [
"tistory-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tistory-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"tistory-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tistory-mcp": {
"command": "uvx",
"args": [
"tistory-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tistory-mcp": {
"command": "uvx",
"args": [
"tistory-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
TISTORY_MCP_SESSION_STOREWhere the blog session cookies are kept: a 0600 file under the config directory, or the OS keyring.TISTORY_MCP_MIN_INTERVAL_SECMinimum number of seconds between publish/update calls. 0 disables the interval.TISTORY_MCP_DAILY_CAPMaximum number of publish/update calls per day. 0 disables the cap.TISTORY_MCP_ALLOW_ANY_HOSTSet to 1 to allow blog hosts outside *.tistory.com (custom domains). Unset by default: only *.tistory.com is accepted.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Free
Free to install from PyPI
Tistory MCP (Unofficial) 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.

