Location MCP Server
About
An MCP (Model Context Protocol) server that provides location data from a local macOS app.
Details
- Author
- sokyran
- GitHub stars
- 2
- Downloads
- 295
- Categories
- Media
Jump to
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Location MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"location mcp server": {
"location-mcp-server": {
"command": "npx",
"args": [
"@sokyran/location-mcp-server"
]
}
}
}
}McpServers
{
"location-mcp-server": {
"command": "npx",
"args": [
"@sokyran/location-mcp-server"
]
}
}Location MCP Server
An MCP (Model Context Protocol) server that provides location data from a local macOS app.
Prerequisites
- macOS (this package launches a macOS app)
- Node.js 16 or higher
Installation
npm install -g @sokyran/location-mcp-server
Or run it directly with npx:
npx @sokyran/location-mcp-server
Usage with Claude Desktop
1. Download the location-getter-agent.app and place it in the same directory where you run the command.
2. Edit your Claude Desktop configuration file:
{
"mcpServers": {
"location": {
"command": "npx",
"args": ["@sokyran/location-mcp-server"]
}
}
}
3. Restart Claude Desktop.
4. You can now use the getCurrentLocation tool in your conversations with Claude.
How It Works
The server:
1. Launches the location-getter-agent.app (which must be in the current directory)
2. Waits for the app to start its HTTP server on port 8080
3. Exposes a getCurrentLocation tool to Claude
4. When invoked, it fetches location data from the local app and returns it
Troubleshooting
- Make sure the location-getter-agent.app is in the same directory where you're running the command
- If you get permission errors, you may need to allow the app in System Preferences > Security & Privacy
- Check that port 8080 is not being used by another application
Instructions
1. Use Xcode, build location-getter
2. Inside Xcode, go to Product -> Show build folder in Finder
3. Here, find Products/Debug/location-getter-agent.app and paste in inside this folder, right near index.ts.
4. npm i, npm run build, npm run start
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
