What can you do with FindMe Photo?

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

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.

Requirements

Node.js 18+
A FindMe Photo account on Free+, Growth, or Pro
A personal API key from https://findme.photo/settings/api

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

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 https://findme.photo/settings/api
Paste the full key including the fm_live_ prefix
Fully quit and restart your AI client

"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

Tier	Rate limit	Monthly quota
Free+	10 req/min	500 / month
Growth	60 req/min	10,000 / month
Pro	300 req/min	Unlimited

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

Install

Add FindMe Photo to your client. Pick the one you use.

claude mcp add findme-mcp -- npx -y findme-mcp

codex mcp add findme-mcp -- npx -y findme-mcp

amp mcp add findme-mcp -- npx -y findme-mcp

{
  "mcpServers": {
    "findme-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "findme-mcp"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "findme-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "findme-mcp"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"findme-mcp","command":"npx","args":["-y","findme-mcp"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "findme-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "findme-mcp"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "findme-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "findme-mcp"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "findme-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "findme-mcp"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "findme-mcp": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "findme-mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "findme-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "findme-mcp"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y findme-mcp

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

12 tools

FindMe Photo exposes 12 tools to a connected agent.

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.

Score

86 / 100

Excellent

Documentation25/25
Maintenance22/25
Trust16/20
Capability11/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 70 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
12 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.7.0Latest	Jun 22, 2026
0.6.0	Jun 22, 2026
0.4.1	Apr 26, 2026
0.3.1	Apr 26, 2026
0.3.0	Apr 26, 2026
0.2.0	Apr 25, 2026
0.1.4	Apr 25, 2026
0.1.3	Apr 24, 2026
0.1.2	Apr 24, 2026
0.1.1	Apr 24, 2026