gingr-mcp

A Model Context Protocol (MCP) server that gives Claude read-only access to your Gingr pet-care facility data — owners, animals, reservations, appointments, services, and staff. Ask Claude things like "What was our daycare occupancy last week?" or "Which customers board most often?" and it can pull the answer straight from your Gingr account.

Read-only by design. This server never creates, edits, or deletes anything in Gingr.

Tools

Related MCP server: MSSQL-MCP

Prerequisites

• Node.js 18+

• Your Gingr subdomain (the mybiz in https://mybiz.gingrapp.com)

• A Gingr API key — in Gingr go to Reports & More → Users → Edit User → API Keys and create one.

Install

Pick whichever is more convenient:

• Option A — One-click (Claude Desktop): download the .mcpb extension, double-click, fill in the form. No terminal, no config files. Best if you're not technical.

• Option B — npm (any MCP host): add a few lines to your client's config. Works with Claude Desktop, Claude Code, Cursor, and other MCP clients.

Either way you'll need your Gingr subdomain and API key (see Prerequisites).

Option A — One-click Desktop Extension (Claude Desktop)

1. Download gingr-mcp.mcpb from the latest release.

2. Double-click it (or in Claude Desktop: Settings → Extensions → Install Extension…).

3. When prompted, enter your Gingr Subdomain and API Key, then click Install.

The API key is stored securely in your OS keychain and never leaves your machine.

Option B — npm

Claude Desktop

Add this to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json), then restart Claude Desktop:

{
  "mcpServers": {
    "gingr": {
      "command": "npx",
      "args": ["-y", "gingr-mcp"],
      "env": {
        "GINGR_SUBDOMAIN": "yourbiz",
        "GINGR_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add gingr \
  --env GINGR_SUBDOMAIN=yourbiz \
  --env GINGR_API_KEY=your-api-key \
  -- npx -y gingr-mcp

npx -y gingr-mcp downloads and runs the latest version on demand — no global install needed.

Configuration

Tips

• Keep reservation/appointment date ranges to ≤ 30 days — very wide ranges can time out on Gingr's side.

• Dates are YYYY-MM-DD.

Local development

cd gingr-mcp
npm install
npm run build
npm test

# Inspect/run with the MCP Inspector
GINGR_SUBDOMAIN=yourbiz GINGR_API_KEY=your-api-key npm run inspector

Releasing

Maintainer? See RELEASING.md for how to publish the npm package and build the .mcpb bundle.

License

MIT © Canisys