npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

findme-mcp

v0.4.1

Published

Official FindMe Photo MCP server. Lets photographers drive wedding gallery operations (create events, upload photos, get analytics) from Claude, ChatGPT, Cursor, and other MCP-compatible AI clients.

Downloads

1,158

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

findmephotofindmephoto

Keywords

mcpmodel-context-protocolfindmefindme-photowedding-photographyphoto-galleryclaudeanthropiccursor

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

| 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

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"

"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

MIT — © 2026 FindMe Photo