PinMeTo Location MCP

version download Install in VS Code Install in Cursor

An MCP server that connects your PinMeTo locations to AI assistants. Ask questions about your business in natural language and get instant insights from Google, Facebook, and Apple.

Works with any MCP-compatible client including Claude Desktop, VS Code, Cursor, and more.

What Can You Do With It?

Ask your AI assistant questions like:

  • "What's my average Google rating across all locations?"
  • "Show me negative reviews that need responses"
  • "Compare this quarter's performance to last year"
  • "Which locations are performing best?"

See Example Prompts for more ideas.

📊 Turn your data into reports. On top of the .mcpb data connection, install the PinMeTo Locations plugin to add formatted PDF and PowerPoint reports across all your locations. See Creating Reports below.

Installation

Claude Desktop (Recommended)

  1. Download the installer: click the .mcpb badge above, or grab pinmeto-location-mcp.mcpb from the latest release

  2. Double-click the downloaded file (with Claude Desktop open), or drag it into Claude Desktop → Settings → Extensions

  3. Enter your PinMeTo API credentials (Account ID, App ID, App Secret) in the install dialog

  4. Done! This installs the data connection — the MCP server and its twelve tools. Start asking questions about your locations.

Get your credentials from PinMeTo Account Settings.

Reports (optional). To also generate PDF and PowerPoint reports:

  1. Open Customize in the sidebar, go to Plugins
  2. Click + in Personal plugins, choose Add marketplace
  3. Enter PinMeTo/claude-plugins
  4. Install PinMeTo Locations — this adds the report skill

Note: While the plugin repository is private, installing requires the Claude GitHub App to have access to it.

Other Installation Options

Platform Method
VS Code Click the VS Code badge above
Cursor Click the Cursor badge above
Claude Code (CLI) The plugin doesn't bundle a server. Run the npm package directly: npx -y @pinmeto/pinmeto-location-mcp with the three PINMETO_* env vars, or use claude mcp add
Manual See Manual Installation

Available Features

Feature What You Can Do
Locations View all your locations, search by name or city
Google Insights Views, searches, direction requests, calls, clicks
Google Reviews Read reviews, filter by rating, find unresponded reviews
Google Ratings Average rating, review count, star distribution
Google Keywords See how customers search for your business
Facebook Insights Page engagement and reach metrics
Facebook Ratings Ratings and recommendations
Apple Insights Apple Maps performance metrics

All insights support time aggregation (daily, monthly, quarterly) and period comparison (month-over-month, year-over-year).

Creating Reports

Generate professional reports from your location data using the PinMeTo Location Reports Skill.

What It Does

Transforms your multi-location analytics into formatted PDF and PowerPoint reports:

  • Monthly, Quarterly, Half-Yearly, and Yearly reports
  • Includes Google, Facebook, and Apple metrics
  • Review ratings and sentiment analysis
  • Search keyword performance
  • Data-driven strategic recommendations

The report skill comes from the PinMeTo Locations plugin; the location data and tools come from the .mcpb. With both installed, ask for "a quarterly report" or "a Q4 board presentation" and the skill activates automatically.

Prefer not to install the plugin? The skill is also available standalone from the skill repository.

Documentation

Guide Description
Getting Started First steps, FAQ, and troubleshooting
Example Prompts Prompts organized by business need
Tools Reference Complete tool documentation
Advanced Features Time aggregation and comparisons
Manual Installation Developer setup instructions

Requirements

Support

Privacy Policy

This server sends your PinMeTo API credentials to PinMeTo's API to fetch your own location data, and returns that data to your MCP client. It stores nothing remotely and transmits nothing to any third party.

  • Collected: your PinMeTo Account ID, App ID, and App Secret, supplied by you at install time.
  • Used for: authenticating requests to the PinMeTo API on your behalf.
  • Stored: credentials remain under your MCP client's control (for example, the macOS Keychain under Claude Desktop); this server never writes them to disk. Location and insights data is cached in memory for the duration of a session and never written to disk.
  • Shared: nothing is shared with third parties.
  • Retained: the server itself retains nothing after the process exits, and its in-memory location and insights cache is discarded then. Credential persistence is managed by your MCP client, not by this server.
  • Contact: PinMeTo Support

Full policy: https://places.pinmeto.com/listings/public/legal/privacypolicy

License

MIT