local-mcp-releases

# LMCP — Give Your AI Native Access to Your Apps

[![npm](https://img.shields.io/npm/v/local-mcp)](https://www.npmjs.com/package/local-mcp)
[![macOS 13+](https://img.shields.io/badge/macOS-13%2B-blue)](https://local-mcp.com)
[![GDPR](https://img.shields.io/badge/GDPR-compliant-green)](https://local-mcp.com/en/privacy)
[![smithery badge](https://smithery.ai/badge/@lanchuske/local-mcp)](https://smithery.ai/server/@lanchuske/local-mcp)

**Let your AI actually use your Mac.** Ask ChatGPT, Claude or Cursor to read & reply to your email, manage your calendar, text over iMessage, find your files, and pull data from PDFs — it just does it. It even reaches iMessage and your local apps that the web AIs can't. Tools run **on-device** — for desktop AIs nothing leaves your Mac; an optional, opt-in encrypted relay lets web AIs reach it. No API keys, free.

```bash
curl -fsSL 'https://local-mcp.com/install?ref=github-releases' | bash
```

> Installs in 2 minutes. Auto-configures Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, and Zed. **Free — no paid tier yet.**

⭐ **Like it? [Star this repo](https://github.com/lanchuske/local-mcp-releases)** — it helps others discover LMCP.

<p align="center">
  <img src="assets/claude-web-demo.gif" alt="Real recording: Claude.ai on the web creating a note and a reminder on a Mac through LMCP, including the consent dialog" width="700">
</p>
<p align="center"><em>Real recording — Claude.ai (web) using a Mac's apps through LMCP's Cloud Relay: ask → tools run → you approve → done. Captured with LMCP's own screen-capture tools.</em></p>

<p align="center">
  <img src="assets/claude-tools.png" alt="Claude Desktop showing tools across 20 categories with LMCP" width="700">
</p>
<p align="center"><em>Native tools across 20 categories — Mail, Calendar, Teams, Slack, WhatsApp, OneDrive, Microsoft 365, Notes, OmniFocus, ServiceNow, and more</em></p>

<details>
<summary>Menu bar app</summary>
<p align="center">
  <img src="assets/tray-app.png" alt="LMCP menu bar app" width="340">
</p>
<p align="center"><em>Status at a glance — all your Mac apps connected</em></p>
</details>

---

## What your AI can do

| App | What you can ask |
|-----|-----------------|
| **Mail** | "Summarize my unread emails" · "Reply to Jana saying I'll be 10 minutes late" · "Find emails from the contracts team last week" |
| **Calendar** | "What do I have tomorrow?" · "Schedule a team sync Friday at 3pm" · "Cancel my 2pm meeting" |
| **Contacts** | "Get Jana's phone number" · "Find everyone at Acme Corp" |
| **Microsoft Teams** | "What did the engineering channel say today?" · "Show my last conversation with Marco" |
| **Slack** | "Summarize #engineering from today" · "What did Ana say in the #design channel?" |
| **WhatsApp** | "Summarize my WhatsApp from this morning" · "Find the chat with Carla about the trip" *(via the unofficial Wacli client — requires QR-code sign-in)* |
| **OneDrive** | "Find the Q1 report" · "Upload this summary to the shared folder" |
| **Google Drive** | "Find the budget sheet in Drive" · "Read the project notes from My Drive" |
| **Zoom** | "Summarize my last meeting" · "What did we agree on in the kickoff call?" |
| **Outlook** | "Read my Outlook inbox" · "Search for invoices from last month" |
| **Microsoft 365** | "Read my Outlook.com inbox" · "Find Sara in the company directory" · "Add a Graph calendar event" |
| **Reminders** | "Add a reminder to call the bank tomorrow at 9am" · "What's on my list?" |
| **To Do** | "Add milk to my shopping list" · "What's due today in To Do?" |
| **OmniFocus** | "Show my overdue tasks" · "Create a task to review the contract" |
| **Notes** | "Search my notes for the API keys" · "Create a note with today's decisions" |
| **Messages** | "What did Ana send me this morning?" · "Search iMessages for the address" |
| **Word / Excel / PPT** | "Read this contract" · "Create a spreadsheet with these numbers" |
| **PDF** | "Summarize this PDF" |
| **Finder** | "Find all files named 'invoice' on my Mac" |
| **Safari** | "List my bookmarks in the Dev folder" |
| **Stocks** | "How is AAPL doing today?" · "Show me a chart of MSFT this month" |
| **ServiceNow** | "Show my open incidents" · "Create a P2 for the outage" · "Search the KB for VPN setup" |
| **Signal** | "Read my Signal chats" · "Search Signal for the address Maria sent" *(read-only, local database)* |
| **Notion** | "Search my workspace for the launch plan" · "Read the roadmap database" |
| **Any website** | "Log in to the supplier portal and download this month's invoices" · "Check this product's price every morning" *(13-tool web-automation engine, persistent sessions)* |
| **NordVPN** | "Is my VPN connected?" · "Recommend a server in Japan" |

239 tools across 22 app categories. Read operations run instantly. Write operations (send email, delete event) show a preview and require confirmation.

---

## Install

```bash
curl -fsSL 'https://local-mcp.com/install?ref=github-releases' | bash
```

Auto-detects and configures: **Claude Desktop · Claude Code · Cursor · Windsurf · VS Code · Zed**

Restart your AI client once. That's it.

### Prefer not to use the terminal?

You don't need the command line. Get the Mac app from **[local-mcp.com](https://local-mcp.com)**, drag it to Applications, and open it. The menu-bar app walks you through connecting Claude Desktop, ChatGPT, Claude.ai, or Grok — no setup files to edit. (The terminal install above also auto-configures Claude Desktop, Cursor, VS Code, and more.)

**Requirements:** macOS 13+ (Ventura or later, Apple Silicon or Intel). Windows & Linux are on the waitlist at [local-mcp.com](https://local-mcp.com).

## Use with ChatGPT (web)

ChatGPT can call your Mac apps through LMCP's Cloud Relay. The full walkthrough with
screenshots is at **[local-mcp.com/guides/chatgpt-mac](https://local-mcp.com/guides/chatgpt-mac)** —
the short version:

1. **Install LMCP** (above) and open the menu bar app → **Settings → Connect**. Enter your
   email, click **Connect**, then toggle **Cloud Data Forwarding** ON.
2. On **[chatgpt.com](https://chatgpt.com)** (web only — Plus/Pro/Business/Enterprise/Edu):
   **Settings → Apps & Connectors → Advanced settings → enable Developer mode**.
3. **Apps & Connectors → Create**: Name `LMCP`, URL `https://www.local-mcp.com/mcp`,
   Authentication **OAuth**.
4. On the **Authorize ChatGPT** page, paste your token (**Settings → Connect → Copy** next to
   **Token**) and click **Authorize**. The token is your secure per-machine credential — no email step.
5. New chat → **+ → More → LMCP**, then ask *"Summarize my unread emails."*

> Using **Claude Desktop, Cursor, VS Code, Windsurf, or Zed**? Skip all of this — `curl … | bash`
> auto-configures them locally and nothing leaves your Mac.

---

## How it works

```
┌─────────────────────────────────┐
│  Claude · Cursor · VS Code · …  │
└───────────┬─────────────────────┘
            │  MCP protocol (stdio)
┌───────────▼─────────────────────┐
│        LMCP server          │
│  JXA · EventKit · AppleScript   │
│  LevelDB · native macOS APIs    │
└───────────┬─────────────────────┘
            │
┌───────────▼─────────────────────┐
│  Mail · Calendar · Teams · …     │
│  Your Mac apps (local data)      │
└─────────────────────────────────┘
```

### Why native?

Most MCP servers call cloud APIs. LMCP talks directly to macOS frameworks:

- **EventKit** for Calendar — reads all providers (iCloud, Google, Exchange)
- **AppleScript/JXA** for Mail — works with any IMAP account
- **LevelDB** for Teams — reads the local IndexedDB cache, no Graph API needed
- **CNContactStore** for Contacts — native framework, no app launch required
- **File system** for OneDrive, Word, Excel, PowerPoint

This means: **no API keys, no OAuth, no rate limits, works offline, sub-second responses.**

### Microsoft Teams without Graph API

The most technically interesting part: Teams messages are read directly from the local LevelDB cache at:

```
~/Library/Containers/com.microsoft.teams2/.../IndexedDB/https_teams.microsoft.com_0.indexeddb.leveldb
```

No Azure AD registration, no tenant admin approval, no OAuth tokens. Just the messages already cached on your Mac.

### Cloud Relay (optional)

Claude.ai and ChatGPT can't reach localhost. Enable Cloud Relay in the menu bar app — a secure WebSocket tunnel routes requests to your local server. Your data is encrypted in transit and never stored.

---

## How LMCP compares

There are several Mac MCP servers — they optimize for different things. An honest read:

| | **LMCP** | Apple-native only (e.g. iMCP) | Cloud aggregators (e.g. Composio) | GUI automation (e.g. Macuse) |
|---|---|---|---|---|
| Apple apps (Mail, Calendar, iMessage…) | ✅ | ✅ | ⚠️ via cloud APIs | ✅ |
| **Teams / Slack / WhatsApp (local, no API)** | ✅ | ❌ | ⚠️ cloud/OAuth | ❌ |
| Works from **web AIs** (ChatGPT, Claude.ai) | ✅ opt-in relay | ❌ | ✅ | ❌ |
| No API keys / OAuth for local apps | ✅ | ✅ | ❌ | ✅ |
| Runs on your Mac (not the cloud) | ✅ | ✅ | ❌ | ✅ |

**Where LMCP is unique:** the work & messaging apps most people live in — **Microsoft Teams, Slack, WhatsApp, Microsoft 365** — read locally with no API keys, *and* reachable from web AIs like ChatGPT and Claude.ai. Apple-native-only servers stop at Apple apps; cloud aggregators need OAuth and route your data through their servers.

Full head-to-head with the other Mac-native servers: **[LMCP vs Macuse vs iMCP](https://local-mcp.com/guides/lmcp-vs-macuse)** — capabilities, pricing and privacy, kept honest and current.

## Recipes — what your AI can *do* (not just read)

LMCP is an action layer: your AI chains tools into whole workflows on your Mac. A few ([more at local-mcp.com/recipes »](https://local-mcp.com/recipes)):

- **Schedule a meeting end-to-end** — find a free slot, message the person on email *and* WhatsApp with options, and book it when they confirm. (No cloud scheduler reaches a personal WhatsApp; LMCP does.)
- **Triage across every channel** — "Ac