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

AI-generated 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.
Before you install
The Imgflip API authenticates with a username and password rather than API keys, so IMGFLIP_PASSWORD is a real account secret stored in the client configuration; a dedicated account is suggested. Meme texts and credentials go to Imgflip, and generated memes are hosted publicly on imgflip.com. Captioning creates content on an external service.

Installation

In SourceWeft

  1. Open Imgflip Mcp in the dashboard and add it to a workspace.
  2. 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 → calls caption_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)

ToolDescriptionImgflip endpointRequirements
get_memesList the ~100 most popular meme templates, with optional name filteringGET /get_memesnone
caption_imageCaption a template and get the generated image URLPOST /caption_imagefree Imgflip account

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)

ToolDescriptionImgflip endpoint
search_memesSearch 1M+ templates by namePOST /search_memes
get_memeLook up a single template by idPOST /get_meme
caption_gifCaption an animated GIF templatePOST /caption_gif
automemeAuto-pick a template for a piece of textPOST /automeme
ai_memeLet Imgflip's AI invent a whole memePOST /ai_meme

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-meme prompt: an MCP prompt that guides the model through template selection and captioning — pass a topic and optionally a template preference.
  • Tool annotations: lookup tools are marked readOnlyHint so 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

VariableRequiredDescription
IMGFLIP_USERNAMEyes*Your Imgflip username
IMGFLIP_PASSWORDyes*Your Imgflip password
IMGFLIP_PREMIUMnoSet to true to also register the five Premium tools (default: off)

* 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:

RouteBest forHow
Desktop Extension (.mcpb)Claude Desktopdownload from Releases, double-click, fill in the credentials form — guide
Claude Code pluginClaude Code/plugin marketplace add mariokernich/imgflip-mcp, then /plugin install imgflip@imgflip-mcp — guide
VS Code buttonCopilot usersclick the Install in VS Code badge above — guide
npxany other clientcommand npx, args ["-y", "imgflip-mcp"] — guide

Every client uses the same shape. For example, in Claude Desktop's claude_desktop_config.json or Cursor's .cursor/mcp.json:

json
{  "mcpServers": {    "imgflip": {      "command": "npx",      "args": ["-y", "imgflip-mcp"],      "env": {        "IMGFLIP_USERNAME": "your-username",        "IMGFLIP_PASSWORD": "your-password"      }    }  }}

Or for Claude Code in one line:

bash
claude mcp add imgflip \  --env IMGFLIP_USERNAME=your-username \  --env IMGFLIP_PASSWORD=your-password \  -- npx -y imgflip-mcp

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:

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

MIT

Source: README.md at commit cf93f55

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v1.1.0LatestOct 9, 2026
  2. 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