flickr-mcp

An MCP server that gives AI assistants authenticated access to your Flickr photo library. Tag photos, write descriptions, set titles, manage group memberships, and run a full automated processing workflow — all driven by AI, applied to your photos.

Works with any MCP-compatible AI client: Claude, Cursor, Windsurf, and others.

What it does

Once connected, you can ask your AI assistant things like:

• "Process all my untagged photos" — scans your whole library, tags and describes everything in one pass
• "Tag all the photos in my Japan album"
• "Write a description for this photo" (with a Flickr URL or photo ID)
• "Find my car photos and add them to relevant Flickr groups"
• "Look at my recent uploads and add relevant tags to each one"

The AI looks at your photos visually (via built-in image fetching), generates metadata from the actual image content and EXIF data, and either previews changes before applying or runs fully automated depending on the tool.

Requirements

• Node.js 18 or later
• A Flickr Pro account — Flickr requires Pro to register API applications
• An MCP-compatible AI client

Setup

1. Register a Flickr API key

Note: Flickr requires a Pro account to register API applications (~$8/month or ~$72/year). If you're using Flickr seriously enough to want AI-assisted tagging, you likely already have one.

Go to flickr.com/services/apps/create/noncommercial and fill out the short form — any app name works, select "personal use." It takes about two minutes. Copy the API key and API secret from the next page.

2. Run the setup command

npx flickr-mcp setup

A browser window will open with a setup wizard. Paste your API key and secret, then follow the prompts to authorize access to your Flickr account. Your credentials are saved to ~/.config/flickr-mcp/credentials.json and never leave your machine.

3. Add flickr-mcp to your AI client

The easiest way is to paste the following prompt directly into your AI assistant. It contains everything needed — the config entry, the setup reminder, and a pointer to the full docs:

Add an MCP server to my config with these details:

• Name: flickr
• Command: npx
• Args: ["flickr-mcp"]

The full config entry is:

"flickr": {
  "command": "npx",
  "args": ["flickr-mcp"]
}

Add this to the mcpServers block in my MCP config file, then let me know where you put it and remind me to restart the client.

Full documentation and source: https://github.com/MK3Core/flickr-mcp

Your assistant knows where its own config file lives and will place the entry correctly regardless of which client you're using. After it confirms, restart the client.

{
  "mcpServers": {
    "flickr": {
      "command": "npx",
      "args": ["flickr-mcp"]
    }
  }
}

{
  "mcpServers": {
    "flickr": {
      "command": "npx",
      "args": ["flickr-mcp"]
    }
  }
}

Full automated workflow

The quickest way to proc

... View full README on GitHub