Skip to content

mihirkavi/open-media

v2.0.0MIT

Open Media for AI agents: one feed and search across Open Media, Farcaster, Lens, Hive and DeSo, your inbox (messages, email, chats) with read receipts, your own feed algorithm, web feeds, events, and your account, with every change confirmed first.

GitHubOpen Website

What you can ask

"Catch me up." Unread messages, email and chats by person, then the five posts in your Feed most worth your time.

"What are people saying about ethereum on Lens and Farcaster?" A summary with every post's network, link and why it was shown.

"Did Priya read my message?" Sent, delivered or read, with the time.

"Less Hive, more videos." Your feed algorithm changes, and you see what changed, the code that now runs your Feed, and how to undo it.

"Follow bbc.co.uk and US weather alerts for California." Official feeds, right in your Feed.

"Reply to Dev that I'll be there at 7." Drafted in your voice, sent only after you say yes.

Results show the way Open Media looks, black and white and content first: posts, your inbox with unread dots and read ticks, your algorithm and its code, events and profiles, in light and dark.

Install

WhereHow
Claude Codeclaude plugin marketplace add mihirkavi/open-media then claude plugin install open-media@open-media
Codexcodex plugin marketplace add mihirkavi/open-media then codex plugin add open-media@open-media
Claude, ChatGPT (connectors)Add a custom connector with https://api.openmedia.site/account/mcp and sign in with Open Media
VS CodeCommand palette → Chat: Install Plugin from Source → mihirkavi/open-media, or add the MCP server
CursorPlugins → install from mihirkavi/open-media, or add the MCP server
Antigravityagy plugin install ./agent-plugin from a clone of the repository
Gemini CLIgemini extensions install https://github.com/mihirkavi/open-media
Skills onlynpx skills add mihirkavi/open-media

Then try /open-media:catch-up, /open-media:inbox, /open-media:feed, /open-media:post, /open-media:algorithm or /open-media:follow in Claude Code, or just ask.

Signing in

Reading the public feed, search, profiles and events needs no account.

For your own account, your agent connects to https://api.openmedia.site/account/mcp and asks you to Sign in with Open Media. A browser page asks for your email, Open Media emails you a code, and you approve what the agent may do. You sign in once. The agent never sees your password or your Open Media session, and signing out in the app disconnects it.

Scripts and CI can use a token instead: https://api.openmedia.site/me/mcp with Authorization: Bearer <token> (see sign-in for agents).

What's inside

  • 3 MCP servers:
    • open-media (public: 23 tools)
    • open-media-account (your account: 91 more, 114 in all)
    • open-media-docs
  • 9 skills that teach an agent to use Open Media well, safely:
    • open-media
    • open-media-inbox
    • open-media-posting
    • open-media-feed-lenses
    • open-media-web-feeds
    • open-media-work
    • open-media-payments
    • open-media-translate
    • verify-listings
  • 6 slash commands for the everyday jobs: catch-up, inbox, feed, post, algorithm and follow.
  • One visual view (MCP Apps) for posts, your inbox, your algorithm, events and profiles. It loads nothing from elsewhere.

Safety, by design

  • Your agent asks before anything that publishes, sends, deletes, pays or changes a setting, and shows you the exact text first.
  • Messages, email, chats and contacts stay private to you.
  • Post, message and email text is treated as data, never instructions.
  • Read receipts are yours to turn off, and turning them off also hides other people's.
  • No algorithm can read private messages, exact location, sensitive traits, KYC documents or emotional state.

For marketplaces and maintainers

One plugin folder serves every catalog (ADR 0027):

FileRead by
.claude-plugin/plugin.json + .mcp.jsonClaude Code, the Claude plugin directory, VS Code (Claude format)
.codex-plugin/plugin.jsonCodex (compatibility layout)
plugin.json + mcp.jsonAgent Plugins standard: Codex, VS Code, Cursor
.antigravity-plugin/plugin.json + mcp_config.jsonAntigravity
../gemini-extension.json + ../GEMINI.mdGemini CLI
registry/*.server.jsonThe official MCP Registry (site.openmedia/*)
skills/*/SKILL.mdEvery client and skills.sh (Agent Skills)

Name, version and servers are kept equal across all of them by a test, and no file holds a token.