MCP.so
Sign In

Location MCP Server

@sokyran

Repository

About Location MCP Server

An MCP (Model Context Protocol) server that provides location data from a local macOS app.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "location-mcp-server": {
      "command": "npx",
      "args": [
        "@sokyran/location-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

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.

Frequently asked questions

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.

Comments

Basic information

Category

Media & Design

Transports

stdio

Author

sokyran

More Media & Design MCP servers

Vibe Design System

mondaycom

🎨 Vibe Design System - Official monday.com UI resources for application development in React.js

657

百度地图 MCP Server

baidu-maps

Baidu Map MCP Server

436

Uwear.ai

Uwear.ai

Run complete AI fashion photoshoots from ChatGPT, Claude, or Codex. Turn flat-lay, packshot, and mannequin product images into catalog-ready on-model photos and video with saved art direction, automatic QA, and catalog-s

YouTube MCP Server

anaisbetts

A Model-Context Protocol Server for YouTube

532

Lamina — On-brand product photos, video & try-ons

Lamina

Generate on brand product videos from Claude Code (or any assistant) in one line. Lamina turns a brief + your brand kit into finished product photos, video reels, and campaign banners - no prompt engineering; brand guard