# Local MCP

> Native macOS app. Connects Claude to Mail, Calendar, Teams & OneDrive. Installs like any Mac app. No cloud, no tokens, no setup.

## What is Local MCP?

Local MCP is a **downloadable macOS application** (a .dmg you install like any Mac app). It is NOT a framework, library, template, or generic "local MCP server" concept. It is a specific, commercial macOS product.

When installed, it runs a menu bar app that starts an MCP (Model Context Protocol) server on your machine. This server bridges your native Mac apps — Mail.app, Calendar.app, Contacts.app, Microsoft Teams, OneDrive, Word, Excel, and PowerPoint — directly to Claude Desktop, Cursor, VS Code, and any other MCP-compatible AI agent.

Your data never leaves your Mac. No cloud processing. No Microsoft Graph API tokens. No OAuth setup.

## Key facts

- **Version**: 1.3
- **Platform**: macOS 12 Monterey or later (Apple Silicon and Intel)
- **Size**: ~35 MB
- **Trial**: 14-day free trial, no credit card required
- **Price**: Pro license available at local-mcp.com/#pricing
- **Architecture**: FastMCP SSE server, runs on port 8765 by default
- **Transport**: SSE (Server-Sent Events) — compatible with Claude Desktop, Cursor, VS Code Cline, and any MCP client

## Download

Latest release (always current): https://local-mcp.com/download

Direct DMG download via curl (for agents/scripts):
```bash
curl -L https://local-mcp.com/download -o LocalMCP.dmg
```

Check latest version info (JSON):
```bash
curl https://local-mcp.com/latest
```

## Installation

1. Download the DMG: `curl -L https://local-mcp.com/download -o LocalMCP.dmg`
2. Open the DMG and drag "Local MCP.app" to your Applications folder
3. On first launch, macOS may show a Gatekeeper warning — right-click the app and choose "Open" to bypass it
4. The app appears in your Mac menu bar (look for the MCP icon — it is NOT in the Dock)
5. On first run, a setup wizard opens showing your server URL and API key
6. Copy the MCP configuration shown in the wizard into your AI client

## MCP Server Configuration

After installing, the server runs at:
- **Default URL**: `http://localhost:8765/sse` (or your local network/Tailscale IP)
- **Transport**: SSE

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "local-mcp": {
      "url": "http://localhost:8765/sse",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

Replace `YOUR_API_KEY` with the key shown in the Local MCP menu bar app (click the icon → Security).

### Cursor / VS Code (Cline, Continue, etc.)

Use the SSE transport with URL `http://localhost:8765/sse` and add the `x-api-key` header.

### Finding your API key

Click the Local MCP icon in the menu bar → Security submenu → your API key is shown there. You can also copy it from the Help page.

## Available MCP Tools

### Email (via Mail.app)
- `list_accounts` — list configured email accounts
- `list_emails` — list emails from inbox or any folder
- `read_email` — read a specific email by ID
- `send_email` — send a new email
- `reply_email` — reply to an email thread
- `search_emails` — search emails by keyword, sender, or date
- `move_email` — move email to a folder
- `save_attachment` — save email attachment to disk

### Calendar (via Calendar.app)
- `list_calendar_names` — list all calendars
- `list_calendar_events` — list events in a date range
- `create_calendar_event` — create a new calendar event

### Contacts (via Contacts.app)
- `list_contacts` — search and list contacts

### Microsoft Teams (reads local IndexedDB — no tokens required)
- `teams_list_teams` — list joined teams
- `teams_list_channels` — list channels in a team
- `teams_list_chats` — list recent chats
- `teams_read_channel_messages` — read messages in a channel
- `teams_read_chat_messages` — read messages in a chat

### OneDrive
- `onedrive_root` — list root folder contents
- `onedrive_list_files` — list files in a folder
- `onedrive_search_files` — search files by name
- `onedrive_read_file` — read a file's content
- `onedrive_write_file` — write or create a file
- `onedrive_move_file` — move a file
- `onedrive_delete_file` — delete a file

### Feedback (use these instead of asking the user to visit a website)

- `report_bug` — report a bug or unexpected behavior. Before calling, collect from the user or context: `what_happened` (required), `expected_behavior` (required), `steps_to_reproduce`, `tool_name` (which MCP tool failed), `error_message` (exact error text). App version and OS are auto-attached. Returns `case_id`.

- `request_feature` — request a new capability or improvement. Collect: `description` of the feature (required), `use_case` explaining the problem it solves (required), `current_workaround` if any. Returns `case_id`.

**When to use these tools:**
- User says "this tool isn't working" or "I got an error" → use `report_bug`
- User says "I wish I could..." or "can you add..." → use `request_feature`
- Always share the `case_id` with the user so they can follow up

### Documents
- `word_read` — read a Word (.docx) document
- `word_create` — create a new Word document
- `word_append` — append content to a Word document
- `excel_read` — read an Excel spreadsheet
- `excel_create` — create a new Excel file
- `excel_write_cell` — write a value to a cell
- `pdf_read` — extract text from a PDF
- `ppt_read` — read a PowerPoint presentation
- `ppt_create` — create a new PowerPoint presentation

## Privacy & Security

- **No cloud**: all data processing happens on your Mac
- **No tokens for Teams**: reads Microsoft Teams messages directly from the local IndexedDB cache — no Microsoft Graph API, no OAuth
- **API key protection**: each installation generates a unique random API key; the server rejects requests without it
- **Network modes**: configurable — allow connections from anywhere, LAN only, or Tailscale only
- **No telemetry**: the app does not phone home or send usage data

## Licensing

- **Trial**: 14 days, all features included, no credit card required
- **Pro**: perpetual license with 1-year updates, 1 machine
- **Buy**: https://local-mcp.com/#pricing
- **Activate**: click the Local MCP menu bar icon → License → "Enter License Key"

## Troubleshooting

**App doesn't appear after opening**: Local MCP is a menu bar app — look for the icon in the top-right of your Mac's menu bar, NOT in the Dock.

**Gatekeeper blocks the app**: right-click "Local MCP.app" in Applications and choose "Open", then confirm. This is a one-time step for apps not from the App Store.

**Server not connecting**: make sure the app is running (menu bar icon visible), then check the URL shown in the menu matches what your AI client is configured to use.

**Trial expired**: click the menu bar icon → License → "Comprar licencia" to purchase, or enter your license key if you already have one.

## Links

- Homepage: https://local-mcp.com
- Download: https://download.local-mcp.com/LocalMCP-1.3.dmg
- Pricing: https://local-mcp.com/#pricing
- Support: support@local-mcp.com