Skip to content
Back to search

tumblr-mcp

Connect Tumblr to ChatGPT, Claude and other AI agents through Cotlet.dev.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cotlet-connect--tumblr-mcp/badge.svg)](/listings/cotlet-connect--tumblr-mcp)

HTML

<a href="/listings/cotlet-connect--tumblr-mcp"><img src="/api/listings/cotlet-connect--tumblr-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 107 lines
  1. # Tumblr MCP server for ChatGPT and Claude
  2. Tumblr has a public API v2 with OAuth. The Cotlet.dev page reports no official Tumblr MCP server, checked 17 October 2026. Cotlet.dev connects ChatGPT, Claude and other AI agents to your own signed-in Tumblr account for blog posts, queues, drafts and asks. Changes ask for your approval by default.
  3. ## What you can ask
  4. > Read posts waiting in my queue.
  5. > List drafts on my blog.
  6. > Draft answers to new asks for my review.
  7. > Queue reblogs tagged pixel art after I approve.
  8. ## Connect in 2 minutes
  9. Start at https://cotlet.dev/signup?app=tumblr, sign in to Tumblr with your own account in your Cotlet Cloud Browser, and create an API key in the console for editors or scripts. Export the key as `COTLET_API_KEY`.
  10. ### ChatGPT
  11. Settings → Apps & Connectors → Create, add connector URL `https://cotlet.dev/mcp/v1/connect`, then sign in with Cotlet.dev using OAuth.
  12. ### Claude
  13. Settings → Connectors → Add custom connector, enter `https://cotlet.dev/mcp/v1/connect`, then sign in with Cotlet.dev.
  14. ### Claude Code
  15. ```bash
  16. claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
  17. ```
  18. ### Cursor
  19. Copy `.cursor/mcp.json` from this repo into your project:
  20. ```json
  21. {
  22. "mcpServers": {
  23. "cotlet": {
  24. "url": "https://cotlet.dev/mcp/v1",
  25. "headers": {
  26. "Authorization": "Bearer ${COTLET_API_KEY}"
  27. }
  28. }
  29. }
  30. }
  31. ```
  32. ## Run it locally (stdio)
  33. This repository provides a local MCP server with seven browser helper tools. It speaks MCP over stdio, lists those helpers without a key, and forwards calls to the hosted Cotlet.dev server. The hosted integration separately provides the 15 workflow tools listed on the live page. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
  34. ```json
  35. {"mcpServers":{"tumblr":{"command":"python3","args":["/absolute/path/to/tumblr-mcp/tumblr_agent.py","serve"],"env":{"COTLET_API_KEY":"your-key"}}}}
  36. ```
  37. Or with Docker:
  38. ```bash
  39. docker build -t tumblr-mcp .
  40. docker run -i --rm -e COTLET_API_KEY tumblr-mcp
  41. ```
  42. Tools: `tumblr_guide`, `tumblr_status`, `tumblr_open`, `tumblr_read`, `tumblr_click`, `tumblr_type`, `tumblr_close`. Without `COTLET_API_KEY` a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
  43. ## Command line
  44. Python 3.10+, nothing else to install. Clone this repository and run:
  45. ```bash
  46. export COTLET_API_KEY="your-key"
  47. python3 tumblr_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
  48. python3 tumblr_agent.py status # is Tumblr ready in your Cotlet.dev account
  49. python3 tumblr_agent.py guide # Tumblr screens and sign-in link
  50. python3 tumblr_agent.py read # open Tumblr, read the page, close the browser
  51. python3 tumblr_agent.py tools # list Cotlet.dev tools
  52. python3 tumblr_agent.py serve # start the stdio MCP server (same as no argument)
  53. ```
  54. ## Questions from Tumblr users
  55. **Does Tumblr have an API?**
  56. Yes. Tumblr has a public API v2 with OAuth for posts, queues, drafts, submissions, follows and notes.
  57. **What does the hosted Tumblr integration provide?**
  58. The live page describes 15 workflow tools for blogs, posts, queues, drafts, asks, notes and follows. This repository supplies seven local browser helper tools that forward to Cotlet.dev.
  59. **Do changes need my approval?**
  60. Posting, editing, reblogging, answering or deleting asks, deleting posts and following blogs ask for approval by default. You can change this per tool.
  61. **Is this official?**
  62. No. Cotlet.dev is independent and is not affiliated with Tumblr.
  63. ## Source
  64. [Tumblr integration and all 15 hosted workflow tools](https://cotlet.dev/integrations/tumblr-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=tumblr)
  65. ---
  66. More: https://cotlet.dev/integrations/tumblr-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=tumblr
  67. Start free: https://cotlet.dev/signup?app=tumblr&utm_source=github&utm_medium=readme&utm_campaign=tumblr

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.