local-mcp
v3.0.277
Published
LMCP — connect Claude Desktop, Cursor, Windsurf to Mail, Calendar, Contacts, Teams, OneDrive on macOS. Privacy-first: all data stays on your Mac.
Maintainers
Readme
LMCP
Give your AI assistant native access to your apps — 153 local tools on macOS for Outlook, Mail, Calendar, Contacts, iMessage, Teams, Slack, WhatsApp, OneDrive, Google Drive, Zoom, Notion, Notes, Reminders, To Do, OmniFocus, Safari, Word, Excel, PowerPoint, Stocks, NordVPN, Microsoft 365, ServiceNow, and more. Everything runs locally. Your data never leaves your machine.
No cloud. No tokens. No API keys. 100% free.
Install
curl -fsSL 'https://local-mcp.com/install?ref=npm' | bashAuto-detects and configures: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, and Zed. Restart your AI client once.
Cursor users: LMCP tools only appear in Agent mode. Open a new Composer window (⌘I) and make sure the mode selector shows Agent (not Chat or Edit). Without Agent mode, the tools are installed but invisible.
Or via npx:
npx -y local-mcp@latest setupMCP config (manual)
{
"mcpServers": {
"local-mcp": {
"command": "npx",
"args": ["-y", "local-mcp@latest"]
}
}
}What it does
LMCP runs a native MCP server that bridges your Mac apps to any AI client:
| Service | Capabilities | |---------|-------------| | Mail | Read, search, send, reply, move — Gmail, Outlook, iCloud, Exchange. Returns Outlook/Exchange categories on each email. | | Calendar | List, create, delete events across all accounts | | Contacts | List, search, get full contact details | | Teams | Read chats, channels, messages, send messages — no Graph API tokens needed | | Slack | List workspaces, channels, read messages — reads local Slack Desktop cache, no token | | WhatsApp | List chats, read and send messages, send files — via Wacli, no cloud | | OneDrive | List, read, write, search, move, delete files | | Google Drive | List, read, write, search the locally-synced Drive folder — no Google API | | Zoom | List local meeting recordings, read transcripts and saved chat — no Zoom API | | Notion | List, read, search pages and databases from the local Notion cache — no Notion API, no integration token | | Documents | Word, Excel, PowerPoint, PDF | | Reminders | List, create, complete reminders across all lists | | To Do | Microsoft To Do tasks (synced via macOS Reminders) | | OmniFocus | List tasks, projects, tags — create and complete tasks | | Notes | List, read, search, create notes | | Messages | List chats, read and search iMessages | | Stocks | Real-time quotes, historical charts, symbol search | | Finder | Search files via Spotlight, list directory contents | | Safari | Bookmarks, open tabs, click/type/fill forms, run JavaScript | | Microsoft 365 | Read/send email, manage calendar, search org directory — device code login, works with Outlook.com and work accounts | | ServiceNow | Search/create incidents, get details, search Knowledge Base — Basic auth | | NordVPN | Status, server recommendations, diagnostics |
153 MCP Tools (macOS)
Email (10): list_accounts list_email_accounts list_emails read_email send_email reply_email search_emails move_email save_attachment create_email_folder
Calendar (5): list_calendar_names list_calendar_events create_calendar_event update_calendar_event delete_calendar_event
Contacts (3): list_contacts search_contacts get_contact
Teams (7): teams_list_teams teams_list_channels teams_list_chats teams_read_channel_messages teams_read_chat_messages teams_send_message teams_send_channel_message
Slack (4): slack_list_workspaces slack_list_channels slack_read_channel_messages slack_search_messages
WhatsApp (5): whatsapp_list_chats whatsapp_read_messages whatsapp_search_messages whatsapp_send_message whatsapp_send_file
OneDrive (9): onedrive_root onedrive_list_files onedrive_read_file onedrive_write_file onedrive_move_file onedrive_delete_file onedrive_search_files onedrive_file_info onedrive_set_scope
Google Drive (6): gdrive_root gdrive_list_files gdrive_read_file gdrive_write_file gdrive_search_files gdrive_file_info
Zoom (2): zoom_list_recordings zoom_read_transcript
Notion (7): notion_list_pages notion_read_page notion_search notion_list_databases notion_read_database notion_list_workspaces notion_open_page
Documents (9): word_create word_read word_append excel_create excel_read excel_write_cell ppt_create ppt_read pdf_read
Outlook (1): outlook_diagnose — health check for Outlook accounts. Use generic Mail/Calendar/Contacts tools for actual Outlook email/calendar access via Mail.app.
Reminders (5): list_reminder_lists list_reminders create_reminder complete_reminder delete_reminder
To Do (4): todo_list_lists todo_list_tasks todo_create_task todo_complete_task
OmniFocus (7): list_omnifocus_tasks list_omnifocus_projects list_omnifocus_folders list_omnifocus_tags search_omnifocus_tasks create_omnifocus_task complete_omnifocus_task
Notes (4): list_notes read_note search_notes create_note
Messages (3): list_message_chats read_messages search_messages
Stocks (3): stocks_get_quote stocks_get_chart stocks_search_symbol
Finder (5): finder_search finder_list fs_list fs_read fs_search
Safari (13): list_safari_bookmarks safari_list_tabs safari_read_tab safari_search_tabs safari_navigate safari_go_back safari_setup_check safari_evaluate_js safari_click safari_type safari_fill_form safari_wait_for safari_query_selector_all
Microsoft 365 (16): connect_m365_account disconnect_m365_account m365_list_emails m365_read_email m365_send_email m365_reply_email m365_search_emails m365_list_events m365_create_event m365_delete_event search_m365_directory get_m365_person list_m365_people_insights m365_list_contacts m365_search_contacts m365_get_contact
ServiceNow (9): connect_servicenow disconnect_servicenow servicenow_list_my_incidents servicenow_search_incidents servicenow_get_incident servicenow_create_incident servicenow_update_incident servicenow_add_comment servicenow_search_kb
NordVPN (3): nordvpn_status nordvpn_servers nordvpn_diagnose
System (13): lmcp_state lmcp_welcome get_config get_datetime daily_brief run_diagnostics run_qa get_audit_log update_local_mcp update_self_diagnosis report_problem signal_friction submit_qa_report
Coming soon (not included in the 153 count above): Evernote (support is being rebuilt) and on-device image generation via Apple's Image Playground.
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
- HTML email support via
html_bodyparameter
Requirements
- macOS 13 Ventura or later (Apple Silicon and Intel)
- One of: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed
Config file locations
| Client | Path |
|--------|------|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Code | ~/.claude.json |
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| VS Code | ~/.vscode/mcp.json |
| Zed | ~/.config/zed/settings.json |
Cursor users
After install, switch to Agent mode in the Cursor chat panel — MCP tools only appear in Agent mode, not in Ask or Edit mode. Click the mode selector at the bottom of the chat input.
Commands
npx -y local-mcp@latest setup # configure all detected AI clients
npx -y local-mcp@latest update # force re-download of the runtime
npx -y local-mcp@latest status # show server statusFull app (optional)
For the menu bar status icon, auto-start on login, and Cloud Relay:
curl -fsSL 'https://local-mcp.com/install?ref=npm' | bashUninstall
curl -fsSL 'https://local-mcp.com/uninstall' | bashStops all background processes, removes the LaunchAgent, deletes the app and binaries, and cleans up MCP config entries from Claude Desktop, Cursor, and other AI clients. Your emails, calendar, and other data are never stored by LMCP and remain completely untouched.
Links
- Website
- GitHub
- Guides
- Support: [email protected]
