Skip to main content
Glama

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-mcp

The 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


More: https://cotlet.dev/integrations/flickr-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=flickr

Start free: https://cotlet.dev/signup?app=flickr&utm_source=github&utm_medium=readme&utm_campaign=flickr

Available Tools

7 tools
flickr_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

    A3.7/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to access, tag, describe, and manage a Flickr photo library, including automated batch processing.
      70 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      29
      40 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      10
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      7
      23 PyPI
      Elastic 2.0