MCP.Market

FindMe Photo MCP server

by findmephoto·io.github.findmephoto/findme-mcp·v0.7.0

Create wedding galleries, upload photos, and pull analytics on FindMe Photo from any AI assistant.

B71/100grade B
What users say
No reviews yet
Be the first
Safety scan
B71/100

full report

Adoption
New

0 stars229 downloads/wk

Reviews

Write one

Nobody has reviewed FindMe Photo yet.

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

FindMe Photo tools (14, 7 write)

write = sends, deletes, buys or posts

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

  • create_eventwrite action

    Create a new FindMe event (a wedding/photo gallery). Returns the event id, a shareable access code, and gallery + QR URLs. Use when the photographer says things like "create an event for Sarah & Mike on April 22" or "make a new gallery called Johnson Wedding". CRITICAL — three album settings are user preferences: album_quality (storage resolution; tier-capped), enable_downloads (guest downloads on

  • delete_eventwrite action

    Soft-delete an event. The event is hidden immediately and photos stop appearing in the gallery, but the data is kept for 7 days so it can be restored with restore_event if needed. After 7 days, the data is permanently purged.

  • get_account_info

    Confirm which FindMe account and Google Drive connection this MCP session is operating on. Returns the FindMe email, plan tier, active event count, and the Google email that Drive is connected with (or null if not connected). ALWAYS call this once at the start of any conversation that involves listing events, uploading photos, importing from Drive, or any account-scoped action — and surface the re

  • get_event

    Get full details for one event — includes stats: photo_count, video_count, total storage, guest visits, selfie searches. Use when the photographer asks about the status or stats of a specific gallery.

  • get_event_analytics

    Get aggregated analytics for an event: guest visits, unique visitors, photos downloaded, selfie searches, and per-day breakdown. Default window is event creation to now. Use when the photographer asks things like "how many people viewed the Johnson wedding?" or "what was the download count?"

  • get_event_qr

    Get a QR code image (PNG) for an event's public gallery URL. Returns the image so the AI can display it to the photographer or save it. Useful for printing signage at events.

  • get_upload_linkwrite action

    Get a no-login "tap-to-upload" link for an event. Returns a URL the photographer opens on any device (phone or computer) to upload photos through the browser's native picker — no account or login required. THIS IS THE WAY TO UPLOAD when you can't read the photographer's local files (i.e. always, in ChatGPT and in Claude web/mobile — anywhere except a locally-installed Claude Desktop with the findm

  • get_usage

    Get the current-month usage for your FindMe account: API requests used/limit, rate limit per minute, storage used/limit, and active event count. Use when the photographer asks about their usage, quota, remaining requests, or plan limits.

  • list_events

    List the photographer's events, most recent first. Returns up to 20 by default; use `cursor` for pagination. Filter with `created_after` (ISO date) to only show recent events.

  • restore_event

    Restore a soft-deleted event within the 7-day recovery window. Fails if the event is already active or past the 7-day cutoff.

  • update_eventwrite action

    Update fields on an existing event: name, event_date, description, tag, access_code, album_quality (storage resolution; changeable only before the first photo is uploaded, and tier-capped), enable_downloads (toggle guest downloads on/off), or is_collaborative (toggle whether other people can upload). Only include the fields you want to change. Use when the photographer wants to rename, re-date, re

  • upload_photos_from_drive_folderwrite action

    Attempt to import photos from a Google Drive folder. IMPORTANT: this is not supported in chat-based AI assistants because Google's drive.file scope (the only Drive scope FindMe is verified for) does not allow apps to list folder contents. The tool always returns a redirect message pointing the photographer at the FindMe web app, where the Google Picker handles authorization in one click. Surface t

  • upload_photos_from_pathswrite action

    Upload photos or videos from local file paths on the photographer's computer to a FindMe event. Each path can be a file, a directory (all supported files inside are uploaded), or a glob (basic). Supported formats: .jpg .jpeg .png .webp .mp4 .mov .webm. Max 50 files per call; auto-chunks if more are found. Max size per file: 50 MB for photos, 500 MB for videos. Photos are automatically resized to t

  • upload_photos_from_urlswrite action

    Upload photos/videos from public URLs to a FindMe event. Useful when the photographer shares Dropbox links, direct Drive download URLs, or similar. The MCP server downloads each URL to a temp buffer and streams it to the event. Photos are automatically resized to the album's storage quality before upload (full-size albums keep originals). Max 50 URLs per call. On success the response includes rich

Public scan report

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

no findings
  • Code scan23 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 qualitystatic API keys via environment variables6/15
  • Maintenancelast push 96 days ago8/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 71/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How FindMe Photo compares

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

Safety score
71/100
higher than 38% of 1,337 Media servers
Tools
14
the typical Media server has 7
Tools that change things
50%
typical: 4%. Fewer write tools means less an agent can break
Downloads a week
229
more than 77% of 365 Media servers with a package

What its tools let an agent do: 7 read · 4 create · 2 change · 1 delete

Install FindMe Photo in Claude Code, Cursor or VS Code

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

claude mcp add findme-mcp -- npx -y findme-mcp
Add to Cursor

What the publisher says

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

FindMe Photo MCP Server

Official Model Context Protocol server for FindMe Photo — the AI-powered wedding gallery platform.

Drive your FindMe galleries from Claude, ChatGPT Codex, Cursor, and any other MCP-compatible AI client. Create events, upload photos, pull analytics — all in natural language.

What it does

"Create a FindMe event for the Sarah & Mike wedding on April 22, upload every photo in ~/Pictures/Sarah-Mike to it, then show me the QR code."

The AI uses this MCP server to do all three steps in one turn.

Tools

Requirements

  • Node.js 18+
  • A FindMe Photo account on Free+, Growth, or Pro
  • A personal API key from

Install

The easiest way: let the AI install itself. Paste a prompt, the AI edits its own config. No hidden files.

For a step-by-step walkthrough aimed at non-technical photographers, see the full install guide.

Claude Desktop

Open Claude Desktop, click the Code tab (not Chat), then paste this prompt (replace the key):

Install the FindMe MCP server for me.

- Server name: findme
- Command: npx
- Args: -y findme-mcp
- Env var: FINDME_API_KEY = fm_live_PASTE_YOUR_KEY_HERE

Edit my claude_desktop_config.json under mcpServers, then tell me to fully quit and reopen Claude.

Claude Code (CLI)

claude mcp add findme --scope user --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp

ChatGPT Codex

codex mcp add findme --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp

Cursor / Windsurf / VS Code / Cline

Use the tool's built-in MCP install UI with:

  • Command: npx
  • Args: -y findme-mcp
  • Env: FINDMEAPIKEY=fmlivexxxxx

ChatGPT web / mobile

Coming soon — requires a hosted MCP endpoint. We're shipping mcp.findme.photo next. In the meantime, use Claude Desktop or Codex.

Any other MCP client

FINDME_API_KEY=fm_live_xxxxx npx findme-mcp

Verify

After restart, you should see findme in your client's tool list (12 tools). Try:

Create a FindMe event called "My First Gallery" for today, then show me the QR code.

Troubleshooting

"MCP server failed to start"

  • Ensure Node.js 18+: node --version
  • First run downloads the package via npx; allow it through your firewall
  • Check the JSON is valid if you edited manually (no trailing commas)

"Your FindMe API key is invalid or has been revoked"

  • Generate a fresh key at
  • Paste the full key including the fmlive prefix
  • Fully quit and restart your AI client

"API access requires Free+, Growth, or Pro"

API access is a paid-tier feature. Upgrade at .

Upload fails with "can't find folder" on macOS

macOS privacy protection. Open System Settings → Privacy & Security → Full Disk Access and add your AI client (Claude Desktop, Terminal, etc.). Then quit and reopen.

Upload partially failed

Shortened. The full README is on GitHub.

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

FindMe Photo: common questions

Is FindMe Photo MCP server safe?
Mostly: it is graded B (71/100). Read the FindMe Photo safety report
How do I install FindMe Photo?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does FindMe Photo need an API key?
Yes. The registry entry asks for FINDME_API_KEY.
Is FindMe Photo maintained?
The last commit was 134 days ago (2026-06-23). The latest release is v0.7.0.
What can I use instead of FindMe Photo?
Servers from other publishers that do the same job: Wellness Nourish MCP server.
How does FindMe Photo compare with other Media MCP servers?
safety score 71/100 (higher than 38% of 1,337 Media servers); tools 14 (the typical Media server has 7); tools that change things 50% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to FindMe Photo

Same job from other publishers: the closest match first, then the best rated.

  • Wellness Nourish
    Local-first nutrition MCP for AI agents: food, barcode, photo, intake, hydration, goals.
    A