Server data from the Official MCP Registry
Flickr MCP server — tag photos, write descriptions, set titles, and add photos to groups using AI.
Flickr MCP server — tag photos, write descriptions, set titles, and add photos to groups using AI.
The flickr-mcp server demonstrates solid security practices with proper OAuth 1.0a authentication, local credential storage, and well-scoped API permissions limited to the user's own photos. Code quality is generally good with appropriate input validation and error handling. Minor findings include lack of request signing verification and some broad error handling patterns, but these do not represent material security risks. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
4 files analyzed · 9 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-mk3core-flickr-mcp": {
"args": [
"-y",
"flickr-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
Once connected, you can ask your AI assistant things like:
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.
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.
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.
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
mcpServersblock 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.
Claude Code — add to ~/.claude/settings.json (global) or .claude/settings.json in a project:
{
"mcpServers": {
"flickr": {
"command": "npx",
"args": ["flickr-mcp"]
}
}
}
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.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.
The quickest way to process your entire library is two tool calls:
flickr_get_unprocessed_photos — scans every photo in your library and returns a list of anything missing tags, a description, or a real title. Raw camera filenames like DSC_0042 or Lightroom export suffixes like IMG_1234-Edit are flagged automatically.
flickr_process_photo — applies title, description, tags, and group assignments to a single photo in one atomic call. The AI fetches the image visually, reads EXIF for camera/lens/location data, generates up to ~20 focused tags following Flickr best practices, writes a concise description, and adds the photo to relevant groups — joining them automatically if needed.
Just ask: "Process all my untagged photos" and the AI will page through the unprocessed list and handle each one.
These are the tools your AI assistant can call once the server is running. You don't interact with them directly — just describe what you want in plain language.
| Tool | Description |
|---|---|
flickr_list_photos | List your photostream, paginated |
flickr_get_photo | Full photo details, optionally including the image itself for visual analysis |
flickr_get_exif | Camera metadata: make, model, lens, GPS, shutter speed, ISO |
flickr_search_my_photos | Search your own photos by keyword or tag |
flickr_get_albums | List your albums |
flickr_get_album_photos | List photos inside an album |
| Tool | Description |
|---|---|
flickr_add_tags | Add tags to a photo (previews before applying by default) |
flickr_remove_tag | Remove a tag from a photo |
flickr_set_metadata | Set a photo's title and/or description (previews before applying by default) |
| Tool | Description |
|---|---|
flickr_search_groups | Search Flickr groups by keyword — returns name, member count, pool size |
flickr_join_group | Join a Flickr group programmatically (accepts group rules automatically) |
flickr_add_to_group | Add a photo to a group pool (previews before applying by default) |
| Tool | Description |
|---|---|
flickr_get_unprocessed_photos | Scan your entire library and return photos missing tags, descriptions, or real titles |
flickr_process_photo | Apply title + description + tags + group assignments in one call, with auto-join |
Individual write tools (flickr_add_tags, flickr_set_metadata, flickr_add_to_group) show a dry-run preview before applying. flickr_process_photo runs without preview by default — it's designed for batch automation.
The AI follows Flickr-specific best practices when generating tags:
This server can only access your own photos. It has no ability to read, search, or modify other users' content. The write access it requests is limited to your account.
Your API credentials are stored locally at ~/.config/flickr-mcp/credentials.json and are never sent anywhere except Flickr's own API.
The server uses a token bucket that targets 3,000 requests/hour (Flickr's limit is 3,600). Burst of up to 10 requests is allowed. Image fetches count against the budget. Under normal use you will not hit this limit.
git clone https://github.com/MK3Core/flickr-mcp
cd flickr-mcp
npm install
npm run build
node dist/index.js setup
Then point your MCP client at node /path/to/flickr-mcp/dist/index.js instead of npx flickr-mcp.
flickr-mcp is free and open source. If it saves you time, a GitHub sponsorship is always appreciated — it helps justify spending more time on projects like this.
Issues and pull requests are welcome. The codebase is intentionally small — around 700 lines of TypeScript across six files.
src/
index.ts Entry point
setup.ts OAuth setup flow
auth.ts OAuth 1.0a implementation + credential storage
rate-limiter.ts Token bucket (3,000 req/hour)
flickr-client.ts Flickr API wrapper
tools.ts All tool definitions and handlers
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.