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 MCP-compatible clients that can run local STDIO servers, including Claude Desktop, the ChatGPT desktop app, VS Code, Cursor, and more.
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
.mcpbdata connection, install the PinMeTo Locations plugin to add formatted PDF and PowerPoint reports across all your locations. See Creating Reports below.
-
Download the installer: click the
.mcpbbadge above, or grab pinmeto-location-mcp.mcpb from the latest release -
Double-click the downloaded file (with Claude Desktop open), or drag it into Claude Desktop → Settings → Extensions
-
Enter your PinMeTo API credentials (Account ID, App ID, App Secret) in the install dialog
-
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:
- Open Customize in the sidebar, go to Plugins
- Click + in Personal plugins, choose Add marketplace
- Enter
PinMeTo/claude-plugins - 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.
The ChatGPT desktop app can run PinMeTo locally as a STDIO MCP server. You need Node.js v22 or later, Git, and PinMeTo API credentials before you start.
-
Get your Account ID, App ID, and App Secret from PinMeTo Account Settings.
-
In the ChatGPT desktop app, open Settings → Plugins, then select the MCPs tab.
-
Select Add → Add MCP server.
-
Enter the following values:
Field Value Name PinMeToType STDIO Command to launch npxArgument 1 -yArgument 2 github:PinMeTo/pinmeto-location-mcpEnvironment variable PINMETO_ACCOUNT_ID= your Account IDEnvironment variable PINMETO_APP_ID= your App IDEnvironment variable PINMETO_APP_SECRET= your App SecretAdd each argument and environment variable in its own row. Leave Environment variable passthrough and Working directory empty.
-
Select Save, then restart when prompted.
-
Start a new Codex task in the desktop app. Enter
/mcpto confirm thatPinMeTois connected, then try: “List my PinMeTo locations.”
If the server cannot find npx, locate it with command -v npx on macOS/Linux,
(Get-Command npx).Source in Windows PowerShell, or where npx in Windows
Command Prompt. Use the returned absolute path as Command to launch.
ChatGPT web: This local STDIO setup is available to Codex in the ChatGPT desktop app. ChatGPT on the web does not read local MCP configuration; web Chat and Work use remote MCP tools supplied by plugins instead. See OpenAI's MCP documentation.
| 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 server directly from GitHub: npx -y github:PinMeTo/pinmeto-location-mcp with the three PINMETO_* env vars, or use claude mcp add |
| Manual | See Manual Installation |
| 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).
Generate professional reports from your location data using the PinMeTo Location Reports Skill.
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.
| 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 |
- An MCP-compatible client (Claude Desktop, VS Code, Cursor, or others)
- For local installation in the ChatGPT desktop app: Node.js v22 or later
- PinMeTo account with API access
- Setup issues: See Troubleshooting
- Feature questions: See FAQ
- Bug reports: GitHub Issues
- PinMeTo account: PinMeTo Support
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
MIT