
Imgflip Mcp
io.github.mariokernichPublished by GitHub account mariokernichv1.1.0Updated Oct 25, 2026
Browse Imgflip meme templates and generate memes (caption images, AI memes) via the Imgflip API
Overview
Local MCP server that lets an assistant browse Imgflip meme templates and caption them into shareable meme images.
- What you can do
- List the most popular meme templates, with optional name filtering, without any account needed (get_memes). Caption a chosen template with text and get back the generated image URL plus an inline image (caption_image). With an optional Premium subscription enabled, search over a million templates, look up a template by id, caption animated GIFs, auto-pick a template for a text, and generate AI-invented memes. A make-meme prompt guides template selection and captioning from a topic.
- When to use it
- Useful when you want reaction images or lighthearted visuals inside a conversation: README sections, release notes, code review replies, retro or standup recaps, incident postmortems, or chat announcements. Not needed for serious image editing or design work.
- Requirements
- Runs locally over stdio, typically launched with npx, so Node.js 22 or newer is required. A free Imgflip account is needed for everything except template listing; credentials are supplied through the IMGFLIP_USERNAME and IMGFLIP_PASSWORD environment variables. The optional Premium tools require an Imgflip API Premium subscription and IMGFLIP_PREMIUM set to true. Network access to the Imgflip API is required.
Installation
In SourceWeft
- Open Imgflip Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
imgflip-mcp
[CI] [npm] [License: MIT] [Install in VS Code]
📚 Full documentation: mariokernich.github.io/imgflip-mcp
There's an MCP server for your database. One for your Kubernetes cluster. One for your cloud bill, one for your ticket system, and at least twelve for reading PDFs. Serious servers for serious work.
But somewhere along the way, the ecosystem forgot the workload that actually keeps engineering teams running: memes.
imgflip-mcp closes that gap. It's a Model Context Protocol server for the Imgflip meme generator API, so Claude (or any other MCP client) can browse thousands of meme templates and caption them mid-conversation — turning your AI assistant into the coworker who always has the right reaction image.
[Drake meme — rejecting: MCP for real business use case; approving: MCP to get more fun]
This meme was, of course, generated by imgflip-mcp itself.
You: "Make me a Drake meme about writing tests vs. testing in production" Claude: 🖼️ calls
get_memes→ callscaption_image→ sends you the image link
Everything you need is a free Imgflip account. An Imgflip API Premium subscription is optional — it unlocks five extra tools (search, GIF captioning, automeme, AI memes), which stay hidden unless you explicitly enable them.
What would I even use this for?
More than you'd think. Once meme generation is one sentence away, it sneaks into real workflows:
- Docs people actually finish reading. Let Claude write your README section and cap it with a fitting meme — retention engineering at its finest.
- Release notes with a punchline. "v2.0: we rewrote everything" hits different next to an Expanding Brain meme of your migration steps.
- Code review, but kind. Answer the 400-line PR with a Two Buttons meme instead of a lecture. Same message, fewer hurt feelings.
- Retros & standups. Feed in the sprint summary, get the This Is Fine recap the team deserves.
- Incident postmortems. Nothing says "blameless" like a well-chosen Disaster Girl on the last slide.
- Slack announcements. Deploy freezes, on-call handovers, "the build is green again" — all measurably more effective as memes.
Is any of this necessary? No. Neither is syntax highlighting, and yet here we are.
Tools
Free tools (enabled by default)
These two tools cover the everyday use case end to end: find a template, put text on it, get the image URL.
Premium tools (optional, opt-in)
These require an Imgflip API Premium subscription and are not registered by default, so free-tier users never see tools that would fail. If you have Premium, enable them by setting IMGFLIP_PREMIUM=true.
Extras
- Inline images: every meme-generating tool returns the result both as URL and as an embedded image (up to 2 MB), so clients like Claude Desktop render the meme directly in the chat.
make-memeprompt: an MCP prompt that guides the model through template selection and captioning — pass atopicand optionally atemplatepreference.- Tool annotations: lookup tools are marked
readOnlyHintso clients can auto-approve them safely.
Prerequisites
- Node.js 22+
- An Imgflip account (sign up for free) — required for every tool except
get_memes
Environment variables
* Only get_memes works without credentials.
Note: The Imgflip API authenticates with username/password form fields — it does not offer API keys. Consider creating a dedicated Imgflip account for API use.
Installation
The server communicates over stdio, so your MCP client launches it as a subprocess — there is no port or daemon to manage. Pick whichever route fits your client:
Every client uses the same shape. For example, in Claude Desktop's claude_desktop_config.json or Cursor's .cursor/mcp.json:
Or for Claude Code in one line:
Add IMGFLIP_PREMIUM=true to the environment if you have API Premium. Then just ask:
"Make a Drake meme: top 'manually formatting code', bottom 'letting the linter do it'."
Documentation
Everything beyond the basics lives on the documentation site:
- Quickstart — from zero to first meme in five minutes
- Creating memes — the two-step workflow, multi-box templates, positioning, colors and fonts
- Tools reference — every tool, parameter and response
- Configuration and Premium tools
- FAQ & troubleshooting — missing credentials, links without images, tools not showing up, …
- Local development, architecture and publishing
Privacy
This server runs locally and is stateless: your Imgflip credentials and meme texts are sent exclusively to https://api.imgflip.com (which requires them for authentication and generation), and nothing is logged, stored, or sent anywhere else. Generated memes are hosted publicly on imgflip.com. Details in PRIVACY.md; Imgflip's own handling is covered by the Imgflip privacy policy.
Contributing
Contributions are welcome — see CONTRIBUTING.md for the guidelines and CHANGELOG.md for release history. Something broken? Open an issue — ideally with the tool call that failed and your client.
This is an independent community project, not affiliated with Imgflip.
License
Source: README.md at commit cf93f55
Tools
0Version history
2- v1.1.0LatestOct 9, 2026
- v1.0.1Sep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts