JSPM

local-mcp

1.50.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 7263
  • Score
    100M100P100Q106862F
  • License SEE LICENSE IN LICENSE

Connect Claude, Cursor, Windsurf and other AI agents to Mail, Calendar, Contacts, Teams and OneDrive on Mac — no cloud, no tokens

Package Exports

  • local-mcp
  • local-mcp/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (local-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

local-mcp

Connect Claude Desktop, Cursor, Windsurf, VS Code and other AI agents to Mail, Calendar, Contacts, Microsoft Teams and OneDrive on Mac.

No cloud. No tokens. No API keys. Your data never leaves your machine.

Install

npm install -g local-mcp

Auto-detects and configures all your AI clients. Restart your AI client once — done.

Zero-install (Claude Desktop / Cursor / Windsurf / VS Code)

Add directly to your MCP config file and restart:

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

Config file locations:

  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Cursor: ~/.cursor/mcp.json
  • Windsurf: ~/.codeium/windsurf/mcp_config.json
  • VS Code (Cline): ~/.vscode/mcp.json
  • Zed: ~/.config/zed/settings.json

Setup wizard

local-mcp setup

Detects all installed clients and writes the config automatically.

What it does

Local MCP runs a native MCP (Model Context Protocol) server that bridges your Mac apps directly to your AI client:

Module Tools
Email list, read, search, send, reply, move (via Mail.app)
Calendar list events, create events (via Calendar.app)
Contacts search, list (via Contacts.app)
Teams read chats, channels, messages (no tokens — reads local cache)
OneDrive list, read, write, search, move, delete files
Word read, create, append documents
Excel read, write cells, create spreadsheets
PowerPoint read, create presentations
PDF extract text

Requirements

  • macOS 12 Monterey or later (Apple Silicon and Intel)
  • Node.js 18+
  • The AI client you want to use (Claude Desktop, Cursor, Windsurf, etc.)

How it works

The npm package downloads a Python runtime (34 MB, cached in `/.local/share/local-mcp/`) and launches the MCP server in stdio mode. The server communicates directly with your AI client — no ports, no network.

For the full experience with menu bar status icon and auto-start:

curl -fsSL https://local-mcp.com/install | bash

Claude.ai web connector

For Claude.ai (web), add a custom connector:

URL: https://www.local-mcp.com/mcp

Settings → Connectors → Add custom connector → paste the URL.

Privacy & Security

  • All data stays on your Mac — no cloud processing
  • Teams integration reads local IndexedDB cache — no Graph API, no OAuth
  • Unique API key per installation
  • 14-day free trial, no credit card

Commands

local-mcp setup      # configure all detected AI clients
local-mcp update     # force re-download of the runtime
local-mcp uninstall  # remove cached runtime
local-mcp status     # show server status