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
MCP server for macOS — connect Claude Desktop, Cursor, Windsurf to Mail, Calendar, Contacts, Teams & OneDrive
All data stays on your Mac. No cloud. No tokens. No API keys.
Install
npm install -g local-mcpAuto-detects and configures Claude Desktop, Cursor, Windsurf, VS Code, and Zed. Restart your AI client once.
Or add directly to your MCP config
{
"mcpServers": {
"local-mcp": {
"command": "npx",
"args": ["-y", "local-mcp@latest"]
}
}
}What it does
Local MCP runs a native MCP server that bridges your Mac apps to any AI client:
| Service | Capabilities |
|---|---|
| Read, search, send, reply — Gmail, Outlook, iCloud, Exchange | |
| Calendar | List, create, delete events across all accounts |
| Contacts | Search and list from Contacts.app |
| Teams | Read chats, channels, messages (no tokens needed) |
| OneDrive | List, read, write, search, move, delete files |
| Documents | Word, Excel, PowerPoint, PDF |
38 MCP Tools
Email: list_accounts, list_emails, read_email, send_email, reply_email, search_emails, move_email, save_attachment
Calendar: list_calendar_names, list_calendar_events, create_calendar_event, delete_calendar_event
Contacts: list_contacts
Teams: teams_list_teams, teams_list_channels, teams_list_chats, teams_read_channel_messages, teams_read_chat_messages
OneDrive: onedrive_root, onedrive_list_files, onedrive_read_file, onedrive_write_file, onedrive_move_file, onedrive_delete_file, onedrive_search_files
Documents: word_create, word_read, word_append, excel_create, excel_read, excel_write_cell, ppt_create, ppt_read, pdf_read
Safety
- Email send/reply always shows a preview before sending — you confirm first
- Calendar events require explicit calendar name — never creates in the wrong one
- All destructive operations require confirmation
Requirements
- macOS 12 Monterey or later (Apple Silicon and Intel)
- Node.js 18+
- One of: Claude Desktop, Cursor, Windsurf, VS Code, Zed
Config file locations
| Client | Path |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| VS Code | ~/.vscode/mcp.json |
| Zed | ~/.config/zed/settings.json |
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 statusFull app (optional)
For the menu bar status icon, auto-start, and Cloud Relay:
curl -fsSL https://local-mcp.com/install | bashLinks
- Website
- npm
- Pricing
- Support: support@local-mcp.com