Flickr MCP Server
Connects to a user's Flickr account to manage photos, albums, tags, privacy settings, comments, and groups. It supports browsing and reading photo data, finding untagged or unalbumed photos, uploading photos, creating albums, commenting, changing privacy, and adding photos to groups, with approval required for sensitive changes by default.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Flickr MCP Server list my Flickr albums with photo counts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Flickr MCP server for ChatGPT and Claude
Connect ChatGPT, Claude and other AI agents to your own Flickr account through Cotlet.dev. The hosted MCP connection provides 13 operations for photos, albums, tags, privacy, comments and groups. Uploads, new albums, privacy changes, comments and group additions ask for approval by default. Cotlet.dev is independent and is not affiliated with Flickr.
What you can ask
List my Flickr albums with their photo counts.
Find photos uploaded last week that have no tags.
Read this photo before drafting a new title and tags.
Find photos that do not belong to an album.
Draft a comment reply and ask before publishing it.
Ask me before changing this photo to family-only visibility.
Related MCP server: Google Photos MCP
Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
ChatGPT
Settings > Apps & Connectors > Create. Use https://cotlet.dev/mcp/v1/connect with OAuth.
Claude
Settings > Connectors > Add custom connector. Use https://cotlet.dev/mcp/v1/connect.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its Flickr tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
Clone this repository and run python3 flickr_agent.py serve with COTLET_API_KEY set.
Or with Docker:
docker build -t flickr-mcp .
docker run -i --rm -e COTLET_API_KEY flickr-mcpThe local server exposes seven browser helper tools, distinct from the 13 hosted workflow tools described on the live page.
Local tools: flickr_guide, flickr_status, flickr_open, flickr_read, flickr_click, flickr_type, flickr_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, nothing else to install. Run from this repo:
export COTLET_API_KEY="your-key"
python3 flickr_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 flickr_agent.py status # is Flickr ready in your Cotlet.dev account
python3 flickr_agent.py guide # Flickr screens and sign-in link
python3 flickr_agent.py read # open Flickr, read the page, close the browser
python3 flickr_agent.py tools # list Cotlet.dev tools
python3 flickr_agent.py serve # start the stdio MCP server (same as no argument)Questions from Flickr users
Does Flickr have an API or an official MCP server?
The live Cotlet.dev page, checked 17 October 2026, describes a full Flickr API for photos, albums, comments, groups and uploads, with no official MCP server. Cotlet.dev provides an independent hosted MCP connection through your own signed-in account.
Which account do I need?
Use your own Flickr account, free or Pro. Sign in through your Cotlet Cloud Browser and enable Flickr for agents.
Which changes ask for approval?
Creating albums, uploading photos, changing privacy, commenting and adding photos to groups ask for approval by default. You can change approval settings per tool.
Does uploading make a photo public?
The upload operation defaults to private. Adding a non-public photo to a group makes it visible to that group, so group additions ask for approval by default.
Does removing a photo from an album delete it?
No. The photo remains in your photostream and other albums.
Live integration
Flickr tools and connection guide
Start free: https://cotlet.dev/signup?app=flickr&utm_source=github&utm_medium=readme&utm_campaign=flickr
Available Tools
7 toolsflickr_clickA
Click a numbered element on the current Flickr page.
Inputs: element (required).
flickr_closeA
Close the Flickr browser session when the work is done, so credits stop running.
Inputs: no named parameters.
flickr_guideA
How to work in Flickr (organize photos, albums and tags, review privacy and manage comments and groups): its screens and the sign-in link. Call this first.
Inputs: task.
flickr_openA
Open a Flickr page in your signed-in Cloud Browser (default https://identity.flickr.com/login) to work with organize photos, albums and tags, review privacy and manage comments and groups.
Inputs: url.
flickr_readB
Read the current Flickr page: its text and numbered buttons, links and fields.
Inputs: element.
flickr_statusA
Check that your Cotlet.dev account and Flickr are ready: account, credits and Flickr connection.
Inputs: no named parameters.
flickr_typeB
Type text into a numbered field on the current Flickr page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
The core browser primitives (open, read, click, type, close) map to clearly distinct actions with little risk of misselection. The only mild overlap is between flickr_guide (how-to/onboarding) and flickr_status (account/credits/connection check), both being informational tools, but their descriptions differentiate them adequately.
All tools follow a uniform flickr_<verb> snake_case pattern (flickr_open, flickr_read, flickr_click, flickr_type, flickr_close). Even the meta tools (flickr_guide, flickr_status) fit the same prefix convention, so naming is fully predictable.
Seven tools is a well-scoped size for a browser-automation wrapper: two onboarding/meta tools plus five lifecycle primitives. Each tool has an evident role and none appears redundant or filler.
The surface covers the essential browser loop: open a session, read the page, click, type, and close to stop credit usage. Minor gaps remain—no explicit in-session navigation/go-back, scroll, wait-for-load, or keyboard/submit primitive—but an agent can largely work around these by re-opening pages or clicking elements.
Related MCP Connectors
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Connect AI agents to bank accounts, transactions, balances, and investments.
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access, tag, describe, and manage a Flickr photo library, including automated batch processing.70 npm1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to work with a user's Google Photos through Google's picker, letting users choose exactly what the agent sees while providing tools for uploading media, creating and sharing albums, writing captions and enrichments, searching app-created media, and managing multiple Google accounts.2940 npm1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to browse and search Adobe Photoshop Lightroom cloud catalogs, view edited photo renditions, download JPEGs, inspect capture and edit metadata, check account storage, and manage API-owned project albums through the Lightroom Partner API.101MIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage a user's own SmugMug account in plain language — creating and securing galleries, auditing visits, renaming and organizing photos, and applying price lists — without needing a SmugMug API key, OAuth setup, or code.723 PyPIElastic 2.0