Location MCP Server logo

Location MCP Server

by sokyran

The Location MCP Server provides location data from a local macOS app to Claude Desktop using the Model Context Protocol. It acts as a bridge, allowing Claude to access your device's location information.

View on GitHub

Last updated: N/A

What is Location MCP Server?

The Location MCP Server is a tool that enables Claude Desktop to access location data from a macOS application. It launches a local app, waits for it to start an HTTP server, and then exposes a getCurrentLocation tool to Claude.

How to use Location MCP Server?

  1. Install the server using npm or npx. 2. Download the location-getter-agent.app and place it in the same directory. 3. Configure Claude Desktop to use the server by adding the appropriate entry in the mcpServers section of the configuration file. 4. Restart Claude Desktop. 5. Use the getCurrentLocation tool in your conversations.

Key features of Location MCP Server

  • Provides location data to Claude Desktop

  • Uses a local macOS app for location retrieval

  • Exposes a getCurrentLocation tool

  • Easy installation and configuration

  • Leverages the Model Context Protocol (MCP)

Use cases of Location MCP Server

  • Allowing Claude to provide location-aware responses

  • Integrating location data into Claude-powered applications

  • Enabling Claude to perform tasks based on the user's current location

  • Building location-based services with Claude

  • Using location information to personalize Claude's interactions

FAQ from Location MCP Server

What are the prerequisites for using this server?

macOS and Node.js 16 or higher.

How do I install the server?

You can install it globally using npm install -g @sokyran/location-mcp-server or run it directly with npx @sokyran/location-mcp-server.

Where do I get the location-getter-agent.app?

Use Xcode, build location-getter. Inside Xcode, go to Product -> Show build folder in Finder. Here, find Products/Debug/location-getter-agent.app and paste in inside this folder, right near index.ts.

What do I do if I get permission errors?

You may need to allow the app in System Preferences > Security & Privacy.

What if port 8080 is already in use?

Ensure that port 8080 is not being used by another application. If it is, you'll need to either stop the other application or configure the location-getter-agent.app to use a different port (and update the server configuration accordingly).