FindMe Photo MCP server
io.github.findmephoto/findme-mcp·v0.7.0Create wedding galleries, upload photos, and pull analytics on FindMe Photo from any AI assistant.
0 stars229 downloads/wk
Reviews
Write oneNobody 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 postsRead from the package source without running it. The installed server may list more.
create_eventwrite actionCreate 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 actionSoft-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_infoConfirm 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_eventGet 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_analyticsGet 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_qrGet 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 actionGet 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_usageGet 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_eventsList 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_eventRestore 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 actionUpdate 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 actionAttempt 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 actionUpload 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 actionUpload 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
- 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
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
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-mcpChatGPT Codex
codex mcp add findme --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcpCursor / 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-mcpVerify
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 NourishLocal-first nutrition MCP for AI agents: food, barcode, photo, intake, hydration, goals.not reviewedGrowingA