Flickr MCP server

by MK3Core·io.github.MK3Core/flickr-mcp·v0.2.1·1 stars

No reviews yet

Flickr MCP server — tag photos, write descriptions, set titles, and add photos to groups using AI.

B82/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B82/100

full report

Adoption

New

1 stars42 downloads/wk

Reviews

Write one

Nobody has reviewed Flickr yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Flickr tools (14, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

flickr_add_tags
Add tags to a photo. When dry_run is true (the default), returns a preview of what would be added without making any changes — use this to confirm with the user before writing.
flickr_add_to_group
Add a photo to a Flickr group pool. You must already be a member of the group. When dry_run is true (the default), previews the action without making changes.
flickr_get_album_photos
List the photos inside a specific album. The response includes the current page number and total page count. If the user wants all photos in the album, call repeatedly incrementing page until all pages are fetched.
flickr_get_albums
List your Flickr albums (photosets) with their titles, descriptions, and photo counts. The response includes the current page number and total page count. If the user wants all albums, call repeatedly incrementing page until all pages are fetched.
flickr_get_exif
Get the EXIF/camera metadata for a photo: camera model, lens, shutter speed, aperture, ISO, GPS coordinates, etc. Useful context for generating accurate tags and descriptions.
flickr_get_photo
Get full details for a single photo: title, description, all tags with their IDs, dates, and location. Optionally include the photo image as base64 so any LLM can visually analyse it.
flickr_get_unprocessed_photos
Find photos that need processing — missing tags, missing description, or still using a raw camera filename (DSC*, IMG_*, Lightroom export suffixes, etc.). Also returns photos with partial processing (e.g. has tags but no description). Use this as the entry point for the full processing workflow, then process each result with flickr_process_photo.
flickr_join_group
Join a Flickr group so photos can be added to its pool. Use flickr_search_groups first to find the group ID. Accepts group rules automatically.
flickr_list_photos
List photos from your Flickr photostream. Returns photo IDs, titles, tags, and thumbnail URLs. The response includes the current page number and total page count. If the user asks to list or see all photos, call this tool repeatedly — incrementing page by 1 each time — until you have fetched every page. Do not stop at page 1 if more pages exist.
flickr_process_photo
Apply a complete set of metadata to a photo in one shot: title, description, tags, and group assignments. No dry_run — designed for the automated full-processing workflow.
flickr_remove_tagwrite action
Remove a tag from a photo by its text. When dry_run is true (the default), returns a preview without making changes.
flickr_search_groups
Search Flickr groups by keyword. Returns group names, IDs (nsid), member counts, and pool sizes. Use this to find relevant groups before adding photos with flickr_add_to_group. Favour groups with higher member counts and pool sizes as a signal of activity. You must be a member of a group before you can add photos to it.
flickr_search_my_photos
Search your own photos by keyword, tags, or both. Only searches your own library — never other users' photos. The response includes the current page number and total page count. If the user wants all matching results, call repeatedly incrementing page until all pages are fetched.
flickr_set_metadata
Set the title and/or description of a photo. When dry_run is true (the default), returns a preview of the changes without writing them.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan15 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 112 days ago8/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Flickr compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 82/100; higher than 63% of 48,255 servers
Tools: 14; the typical server has 7
Tools that change things: 7%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 1; more than 65% of 28,688 servers
Downloads a week: 42; more than 34% of 12,191 servers with a package

What its tools let an agent do: 13 read · 1 change

Install Flickr in Claude Code, Cursor or VS Code

Runs npx -y flickr-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add flickr-mcp -- npx -y flickr-mcp

Add to Cursor

What the publisher says

From the Flickr repository's README, as published. We do not edit it. Read it on GitHub

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:

json

"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.

Prefer to do it manually?

Claude Code — add to ~/.claude/settings.json (global) or .claude/settings.json in a project:

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

Claude Desktop

Mac: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json

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

Cursor / Windsurf — check your client's MCP settings panel, or ask your assistant to find and edit the config file for you.

Full automated workflow

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Flickr: common questions

Is Flickr MCP server safe?: Mostly: it is graded B (82/100). Read the Flickr safety report
How do I install Flickr?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Flickr need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Flickr maintained?: The last commit was 150 days ago (2026-06-07). The latest release is v0.2.1.
How does Flickr compare with other MCP servers?: safety score 82/100 (higher than 63% of 48,255 servers); tools 14 (the typical server has 7); tools that change things 7% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.