Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-findmephoto-findme-mcp": {
"args": [
"-y",
"findme-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Official Model Context Protocol server for FindMe Photo — the AI-powered wedding gallery platform.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'findme-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked findme-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in productivity
Dynamic problem-solving through sequential thought chains
Persistent memory using a knowledge graph
mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local
Local-first AI memory with knowledge graphs and hybrid search. 17+ AI tools via MCP. Free.
MCP Security Weekly
Get CVE alerts and security updates for io.github.findmephoto/findme-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
"Create a FindMe event for the Sarah & Mike wedding on April 22, upload every photo in
~/Pictures/Sarah-Miketo it, then show me the QR code."
The AI uses this MCP server to do all three steps in one turn.
| Tool | Purpose |
|---|---|
create_event | Create a new gallery. |
list_events | List your events (paginated). |
get_event | Get event details + stats. |
update_event | Rename, re-date, or change access code. |
delete_event | Soft-delete with 7-day recovery. |
restore_event | Un-delete within 7 days. |
upload_photos_from_paths | Upload local files or folders. Primary upload tool. |
upload_photos_from_urls | Upload from public URLs (Dropbox, direct Drive links, etc.). |
upload_photos_from_drive_folder | Import from Google Drive (partial in v1). |
get_event_qr | PNG QR code pointing to the public gallery. |
get_event_analytics | Guest visits, unique visitors, downloads, selfie searches. |
get_usage | Current-month API usage, storage, event totals. |
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.
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 mcp add findme --scope user --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp
codex mcp add findme --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp
Use the tool's built-in MCP install UI with:
npx-y findme-mcpFINDME_API_KEY=fm_live_xxxxxComing soon — requires a hosted MCP endpoint. We're shipping mcp.findme.photo next. In the meantime, use Claude Desktop or Codex.
FINDME_API_KEY=fm_live_xxxxx npx findme-mcp
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.
node --versionnpx; allow it through your firewallfm_live_ prefixAPI access is a paid-tier feature. Upgrade at https://findme.photo/pricing.
macOS privacy protection. Open System Settings → Privacy & Security → Full Disk Access and add your AI client (Claude Desktop, Terminal, etc.). Then quit and reopen.
The tool never errors a whole batch for one bad file — it returns a summary showing which files succeeded and which didn't. Ask th