English Français العربية

io.github.lo-nau/localgym-mcp-server

Official registry Search and web

Read-only MCP server for UK gym search using the LocalGym Agent API.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package localgym-mcp-server
Claude Code 
claude mcp add localgym-mcp-server -e 'LOCALGYM_API_BASE=<LOCALGYM_API_BASE>' -e 'LOCALGYM_MCP_RATE_LIMIT_MAX=<LOCALGYM_MCP_RATE_LIMIT_MAX>' -e 'LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS=<LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS>' -- npx -y localgym-mcp-server@0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "localgym-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "localgym-mcp-server@0.1.2"
            ],
            "env": {
                "LOCALGYM_API_BASE": "<LOCALGYM_API_BASE>",
                "LOCALGYM_MCP_RATE_LIMIT_MAX": "<LOCALGYM_MCP_RATE_LIMIT_MAX>",
                "LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS": "<LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS>"
            }
        }
    }
}

Environment variables

  • LOCALGYM_API_BASE Optional LocalGym API base URL override; defaults to https://localgym.uk.
  • LOCALGYM_MCP_RATE_LIMIT_MAX Optional local MCP client-side rate limit per window; defaults to 60. The public API also enforces server-side limits.
  • LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS Optional local MCP client-side rate limit window in milliseconds; defaults to 60000.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. LocalGym MCP Server
  2. Why this exists
  3. Tools
  4. Quick start
  5. MCP client config
  6. Hermes Agent config
  7. Example tool arguments
  8. Test
  9. Usage policy
  10. License

LocalGym MCP Server

Read-only MCP server for searching, comparing, and recommending UK gyms using the public LocalGym Agent API.

Why this exists

LocalGym covers 18,000+ UK gyms and fitness centres. This MCP server gives AI assistants and agent workflows a small, attributable interface for local gym discovery without exposing the private LocalGym website codebase.

Tools

ToolDescription
search_gymsSearch UK gyms by name, keyword, location, or user intent.
get_gym_detailsReturn structured details for a LocalGym gym slug.
recommend_gymsRecommend gyms for a user goal and location.
compare_gymsCompare several gyms by LocalGym slug.

Quick start

Run directly from npm:

npx -y localgym-mcp-server

Or clone and run locally:

git clone https://github.com/lo-nau/localgym-mcp-server.git
cd localgym-mcp-server
npm install
npm start

The server uses https://localgym.uk by default. To override it:

LOCALGYM_API_BASE=https://localgym.uk npx -y localgym-mcp-server

MCP client config

Recommended npm-based config:

{
  "mcpServers": {
    "localgym": {
      "command": "npx",
      "args": ["-y", "localgym-mcp-server"],
      "env": {
        "LOCALGYM_API_BASE": "https://localgym.uk"
      }
    }
  }
}

Local clone config:

{
  "mcpServers": {
    "localgym": {
      "command": "node",
      "args": ["/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs"],
      "env": {
        "LOCALGYM_API_BASE": "https://localgym.uk"
      }
    }
  }
}

Hermes Agent config

mcp_servers:
  localgym:
    command: "npx"
    args: ["-y", "localgym-mcp-server"]
    env:
      LOCALGYM_API_BASE: "https://localgym.uk"

If you cloned the repo locally instead, use:

mcp_servers:
  localgym:
    command: "node"
    args: ["/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs"]
    env:
      LOCALGYM_API_BASE: "https://localgym.uk"

Example tool arguments

search_gyms
{
  "query": "personal training",
  "location": "Manchester",
  "limit": 5
}
get_gym_details
{
  "slug": "kent-sports-fitness"
}
recommend_gyms
{
  "intent": "beginner friendly gym with personal training",
  "location": "Leeds",
  "limit": 5
}
compare_gyms
{
  "slugs": [
    "kent-sports-fitness",
    "the-box-private-personal-training-studio"
  ]
}

Test

npm test

You can also smoke-test tool discovery by sending MCP JSON-RPC frames over stdio from an MCP client.

Usage policy

V1 is free, read-only, and attribution-first. Please link back to returned localgym_url values when using LocalGym data in public answers.

The public LocalGym Agent API enforces server-side rate limits. This MCP wrapper also includes a local courtesy limiter, defaulting to 60 tool calls per 60 seconds per running MCP process. You can lower it with LOCALGYM_MCP_RATE_LIMIT_MAX or LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS; high-volume/commercial use should be arranged first.

For high-volume, commercial, affiliate, or claimed-listing use, contact enquiries@localgym.uk.

License

MIT

Frequently asked questions

What is io.github.lo-nau/localgym-mcp-server?

Read-only MCP server for UK gym search using the LocalGym Agent API.

How do I install io.github.lo-nau/localgym-mcp-server?

It runs on your machine. In Claude Code: claude mcp add localgym-mcp-server -e 'LOCALGYM_API_BASE=<LOCALGYM_API_BASE>' -e 'LOCALGYM_MCP_RATE_LIMIT_MAX=<LOCALGYM_MCP_RATE_LIMIT_MAX>' -e 'LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS=<LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS>' -- npx -y localgym-mcp-server@0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.lo-nau/localgym-mcp-server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.lo-nau/localgym-mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.lo-nau/localgym-mcp-server?

It is published by lo-nau. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.