FindMe Photo

io.github.findmephotoPublished by GitHub account findmephotov0.7.0Updated Oct 24, 2026

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

The publisher's own server: Cool property search server!

VerifiedSTDIODesktop onlyData & AnalyticsMedia & Design

Overview

AI-generated overview

Official FindMe Photo MCP server that lets an AI assistant create wedding galleries, upload photos, fetch QR codes and pull gallery analytics.

What you can do
Create, list, view, update, soft-delete and restore FindMe events and galleries, including access codes and dates. Upload photos and videos from local files or folders, from public URLs, or poll a Google Drive import. Retrieve a PNG QR code pointing to a public gallery. Read event analytics such as guest visits, unique visitors, downloads and selfie searches, plus current-month API usage and storage.
When to use it
Useful for photographers and FindMe Photo account holders who want to set up wedding galleries, bulk-upload photo folders and check gallery traffic from a chat client instead of the web dashboard.
Requirements
Runs locally via npx, so Node.js 18 or newer is needed, and the first run downloads the package (firewall access required). A FindMe Photo account on the Free+, Growth or Pro tier is required, plus a personal API key supplied in the FINDME_API_KEY environment variable. macOS may need Full Disk Access for the AI client to read photo folders.
Before you install
Requires a personal API key in FINDME_API_KEY, which grants access to the account's galleries. Tools can create, rename, re-date, change access codes on, and soft-delete events, and upload files to FindMe's servers, so photos leave the local machine. API access is a paid-tier feature with per-tier rate limits and monthly quotas, and uploads are capped per file and per batch.

Installation

In SourceWeft

  1. Open FindMe Photo in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

ToolPurpose
create_eventCreate a new gallery.
list_eventsList your events (paginated).
get_eventGet event details + stats.
update_eventRename, re-date, or change access code.
delete_eventSoft-delete with 7-day recovery.
restore_eventUn-delete within 7 days.
upload_photos_from_pathsUpload local files or folders. Primary upload tool.
upload_photos_from_urlsUpload from public URLs (Dropbox, direct Drive links, etc.).
upload_photos_from_drive_folderImport from Google Drive (partial in v1).
get_event_qrPNG QR code pointing to the public gallery.
get_event_analyticsGuest visits, unique visitors, downloads, selfie searches.
get_usageCurrent-month API usage, storage, event totals.

Requirements

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)

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

ChatGPT Codex

bash
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: FINDME_API_KEY=fm_live_xxxxx

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

bash
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"

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

API access is a paid-tier feature. Upgrade at https://findme.photo/pricing.

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

The tool never errors a whole batch for one bad file — it returns a summary showing which files succeeded and which didn't. Ask the AI to retry the failed ones specifically.

Limits

TierRate limitMonthly quota
Free+10 req/min500 / month
Growth60 req/min10,000 / month
Pro300 req/minUnlimited

Per file: 50 MB photos, 500 MB videos, 50 files per upload batch.

v1 limitations

  • upload_photos_from_drive_folder requires an existing Drive import created via the findme.photo web UI; the MCP can poll status but not create imports yet.
  • The MCP runs locally on the same machine as your AI client; it only sees files on that machine.

Resources

License

MIT — © 2026 FindMe Photo

Source: README.md at commit 5171414

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.7.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Find-Me integrations

Cool property search server!

casa.find-me.sub1Official publisher

Cool property search server!'s hosted MCP server, published by sub1.find-me.casa; credential required; Streamable HTTP; 1 tool.

Streamable HTTPWeb executableAuth
1 toolNov 1, 2026