Location MCP Server

What is Location MCP Server?

Location MCP Server is an MCP (Model Context Protocol) server that provides location data from a local macOS app. It is designed for macOS users who want to give AI assistants like Claude Desktop the ability to retrieve the user’s current location.

How to use Location MCP Server?

Install it globally with npm install -g @sokyran/location-mcp-server or run it directly via npx @sokyran/location-mcp-server. For Claude Desktop, download the location-getter-agent.app, place it in the directory where you run the command, and add a location entry to the Claude Desktop configuration pointing to npx @sokyran/location-mcp-server. After restarting Claude, you can invoke the getCurrentLocation tool in conversations.

Key features of Location MCP Server

• Exposes a single getCurrentLocation tool to MCP clients.
• Launches a local macOS app (location-getter-agent.app) to fetch coordinates.
• Communicates with the local app over HTTP (port 8080).
• Requires no cloud services; all location retrieval happens locally.

Use cases of Location MCP Server

• Let Claude Desktop answer questions like “Where am I right now?”
• Enable location‑aware automations or reminders within AI conversations.
• Provide geographic context for other local tools or scripts.

FAQ from Location MCP Server

What are the prerequisites?

The server requires macOS (it launches a macOS app) and Node.js 16 or higher.

How do I install and configure it?

Run npm install -g @sokyran/location-mcp-server (or use npx). Place location-getter-agent.app in the current directory. Then add the server definition to your Claude Desktop configuration file as shown in the README.

What tool does it expose?

It exposes a single MCP tool named getCurrentLocation. When invoked, the server fetches the current location from the local app and returns it.

Why does the server need the location-getter-agent.app?

The app is the component that actually retrieves GPS or system location data. The server launches it, waits for its HTTP server, then queries it for coordinates.

What should I do if I get permission errors?

Open System Preferences > Security & Privacy and allow the app to run. Also ensure port 8080 is not occupied by another application.