Skip to content

Getting Started with LMCP

In short: Connect your AI assistant to Mail, Calendar, Contacts, Teams, OneDrive, and more — all running privately on your Mac.

L
LMCP··5 min read

Average 4.7 out of 5 · Ratings: 73See all reviews →

  • “Me ayuda para todas mis tareas diarias”

    Alejo M.
  • “helps me out so much with daily tasks”

    LMCP user
  • “ansolutely amazing! love pairing it with my AI and watching my productivity increase literally tenforld.”

    Andrew S.

Which AI apps LMCP sets up

Mac

AppHow LMCP sets it upThen
Claude DesktopAutomatically (installer and menu)Restart the app
Claude CodeAutomatically (installer and menu)Open a new session
CursorAutomatically (installer and menu)Restart it and use Agent mode
Windsurf (Devin)Automatically (installer and menu)Restart the app
VS CodeAutomatically (installer and menu)Restart the app
ZedAutomatically (installer and menu)Restart the app
LM StudioAutomatically (installer and menu)Restart the app
WarpAutomatically (installer and menu)Turn LMCP on in its MCP settings
AntigravityAutomatically (installer and menu)Restart the app
ClineFrom the app's own MCP settingsRestart the app
Roo CodeAutomatically (installer and menu)Restart the app
ChatGPT / CodexAutomatically (installer and menu)Restart the app
JanAutomatically (installer and menu)Restart the app
OpenCodeAutomatically (installer and menu)Restart the app
GooseAutomatically (installer and menu)Restart the app
HermesAutomatically (installer and menu)Restart the app
RaycastFrom the app's own MCP settings · Guide
MstyFrom the app's own MCP settings · Guide
Cherry StudioFrom the app's own MCP settings · Guide

Windows

AppHow LMCP sets it upThen
Claude DesktopAutomatically (installer and menu)Restart the app
Claude CodeAutomatically (installer and menu)Open a new session
CursorAutomatically (installer and menu)Restart it and use Agent mode
Windsurf (Devin)Automatically (installer and menu)Restart the app
VS CodeAutomatically (installer and menu)Restart the app
ZedFrom the app's own MCP settingsRestart the app
LM StudioFrom the app's own MCP settingsRestart the app
WarpAutomatically (installer and menu)Turn LMCP on in its MCP settings
AntigravityAutomatically (installer and menu)Restart the app
ClineAutomatically (installer and menu)Restart the app
Roo CodeAutomatically (installer and menu)Restart the app
ChatGPT / CodexAutomatically (installer and menu)Restart the app
JanFrom the app's own MCP settingsRestart the app
OpenCodeFrom the app's own MCP settingsRestart the app
GooseFrom the app's own MCP settingsRestart the app
HermesFrom the app's own MCP settingsRestart the app
RaycastFrom the app's own MCP settings · Guide
MstyFrom the app's own MCP settings · Guide
Cherry StudioFrom the app's own MCP settings · Guide

To connect Claude Desktop or Cursor to Mail, Calendar and your other Mac apps, install LMCP and restart your AI client. The installer adds LMCP to it for you.

Time to complete: ~5 minutes
Requirements: macOS 13 or later (Apple Silicon or Intel), Claude Desktop or Cursor


Step 1 — Install LMCP

Download LMCP and install it:

  1. Open the downloaded LMCP-Installer.dmg from your Downloads folder
  2. Open LMCP Installer — it installs LMCP to your Applications folder for you (no dragging)
  3. LMCP opens automatically and appears in your menu bar

Takes about 30 seconds. The installer auto-configures your AI clients — nothing to drag or set up by hand.

When you open LMCP for the first time, it will:

  • Appear in your menu bar and start the local MCP server — the app is the server, there is no separate daemon to install
  • Auto-detect and configure any installed AI clients (Claude Desktop, Claude Code, Cursor, Devin Desktop (formerly Windsurf), VS Code, Zed)
  • Keep itself up to date automatically

LMCP executes local tools on your device. Cloud AI providers and connected services can receive requested data; their terms apply.


Step 2 — Connect your AI client

Claude Desktop (recommended for most users)

The installer automatically adds LMCP to your Claude Desktop config. You just need to restart Claude Desktop for the change to take effect.

  1. Quit Claude Desktop completely (Cmd+Q, or right-click the dock icon → Quit)
  2. Reopen Claude Desktop
  3. Start a new conversation

That is it. No manual config editing required.

Manual config (if auto-setup did not run)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in a text editor and add:

{
  "mcpServers": {
    "local-mcp": {
      "command": "npx",
      "args": ["-y", "local-mcp@latest"],
      "env": { "LMCP_ORIGIN": "manual" }
    }
  }
}

Then restart Claude Desktop.

Cursor

Cursor requires Agent mode to use MCP tools. Standard Chat mode will not show the tools.

  1. Open Cursor Settings → MCP Servers
  2. Add a new server:
    • Name: local-mcp
    • Command: npx
    • Args: -y local-mcp@latest
  3. Save and restart Cursor
  4. Switch to Agent mode when starting a conversation

Claude Code

Run npx -y local-mcp@latest setup in your terminal. It auto-detects and configures Claude Code. Then restart Claude Code. Also using Codex, or want the manual commands? See Claude Code & Codex on Mac.

Other clients (Devin Desktop, VS Code, Zed)

Add the MCP server config pointing to npx -y local-mcp@latest, then restart the client. For VS Code, use the Cline or Continue extension. Full walkthroughs: VS Code, Devin Desktop, Zed.


Step 3 — Make your first tool call

Verify the connection:

Run diagnostics on LMCP and tell me which tools are available.

Read your emails:

What are my 5 most recent unread emails?

Check your calendar:

What is on my calendar today and tomorrow?

Get a daily brief:

Give me a morning brief — my emails, calendar events, and reminders for today.

Verifying it is working

After your first tool call, you will see tool use blocks showing which tools were called. If Claude responds with your actual email or calendar data, LMCP is set up correctly.

You can also ask:

Run run_diagnostics and show me the full health report.

Granting permissions

On first use, macOS will prompt you to grant access to Contacts, Calendar, and Reminders. Click Allow. If you denied access, go to System Settings → Privacy & Security to re-enable.


Common issues

“I do not see any LMCP tools in Claude Desktop”

Quit Claude Desktop completely (Cmd+Q) and reopen. Then verify:

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

You should see "local-mcp" in mcpServers. If not, re-run the installer.

“Cursor is not using the tools”

Switch to Agent mode — tools are not available in standard Chat mode.

“Claude says it cannot access my email”

Check that Mail.app is open, your account is configured in it, and LMCP has the needed permissions in System Settings → Privacy & Security → Automation.

“The install command failed”

Try:

npx -y local-mcp@latest setup

What is next

Have a question? Ask Claude to use the report_problem tool, or open the LMCP tray icon and click Report Problem.

Comments

Questions and experiences welcome — comments are reviewed before they appear.