🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP
Sign In

local-mcp

Package Overview
Dependencies
Maintainers
1
Versions
485
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install
Malware was recently detected in this package.

Affected versions:

3.0.340

local-mcp

Let ChatGPT, Claude, Cursor & any MCP client actually use your Mac — read & reply to email, manage your calendar, text over iMessage, find files, work with Teams, Slack & Office. On your Mac, no API keys, free.

latest
Source
npmnpm
Version
3.0.360
Version published
Weekly downloads
5.7K
41.56%
Maintainers
1
Weekly downloads
 
Created
Source

Local MCP

The only Mac MCP you can use from ChatGPT & Claude.ai on the web — plus 252 local tools for Claude Desktop, Cursor, Windsurf, VS Code & Zed. Connect any AI to Mail, Calendar, Contacts, iMessage, Teams, Slack, WhatsApp, Signal, OneDrive, Google Drive, Microsoft 365, Notes, Reminders, OmniFocus, Safari, Chrome, Word/Excel/PowerPoint and more. 100% local, no API keys, free — your data never leaves your machine.

npm macOS Signed Privacy

No cloud. No tokens. No API keys. 100% free.

 

Install

MethodBest for
InstallerDownload LMCP-Installer.pkgMost users and managed fleets (MDM-deployable)
Terminalcurl -fsSL 'https://local-mcp.com/install?ref=npm' | bashOne-line setup
npxnpx -y local-mcp@latest setupConfiguring AI clients from an existing Node environment

Auto-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.

MCP 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:

ServiceCapabilities
MailRead, search, send, reply, move — Gmail, Outlook, iCloud, Exchange. Returns Outlook/Exchange categories on each email.
CalendarList, create, delete events across all accounts
ContactsList, search, get full contact details
TeamsRead chats, channels, messages, send messages — no Graph API tokens needed
SlackList workspaces, channels, read messages — reads local Slack Desktop cache, no token
WhatsAppList chats, read and send messages, send files — via Wacli, no cloud
SignalList chats, read and search messages, preview a send — reads local Signal Desktop database, no network
OneDriveList, read, write, search, move, delete files
Google DriveList, read, write, search the locally-synced Drive folder — no Google API
ZoomList local meeting recordings, read transcripts and saved chat — no Zoom API
NotionList, read, search pages and databases from the local Notion cache — no Notion API, no integration token
DocumentsWord, Excel, PowerPoint, PDF
RemindersList, create, update, complete reminders (with priority); move between lists; create/rename/delete lists
To DoMicrosoft To Do tasks (synced via macOS Reminders)
OmniFocusList tasks, projects, tags — create and complete tasks
NotesList, read, search, create notes
MessagesList chats, read, search, and send iMessages
StocksReal-time quotes, historical charts, symbol search
WeatherCurrent conditions + forecast for any city (Open-Meteo, no key)
FinderSearch files via Spotlight, list directory contents
SafariBookmarks, open tabs, click/type/fill forms, run JavaScript
ChromeOpen tabs, navigate, read pages, click/type/fill forms, run JavaScript
Microsoft 365Read/send email, manage calendar, search org directory — device code login, works with Outlook.com and work accounts
ServiceNowSearch/create incidents, get details, search Knowledge Base — Basic auth
NordVPNStatus, server recommendations, diagnostics
Image PlaygroundGenerate images on-device from a text prompt — Apple Intelligence, no cloud, no API key (requires macOS 15.4+)
Skills / RecipesSave a working multi-tool flow as a reusable skill, rerun it, export to share with others & import theirs, see run history, manage in Settings → Skills

 

All 252 tools (macOS)

Email (12): list_accounts list_email_accounts list_emails read_email send_email reply_email create_draft search_emails move_email save_attachment create_email_folder list_email_folders

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 (9): teams_list_teams teams_list_channels teams_list_chats teams_read_channel_messages teams_read_chat_messages teams_search_messages teams_call_history teams_send_message teams_send_channel_message

Slack (4): slack_list_workspaces slack_list_channels slack_read_channel_messages slack_search_messages

WhatsApp (7): whatsapp_connect whatsapp_disconnect whatsapp_list_chats whatsapp_read_messages whatsapp_search_messages whatsapp_send_message whatsapp_send_file

Signal (5): signal_connect signal_list_chats signal_read_messages signal_search_messages signal_compose_guidance

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

Image Playground (1): image_playground_generate

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 (9): get_reminder_folders list_reminders create_reminder update_reminder complete_reminder delete_reminder create_reminder_list rename_reminder_folder delete_reminder_folder

To Do (4): todo_get_folders 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 (5): list_notes read_note search_notes create_note update_note

Messages (4): list_message_chats read_messages search_messages send_message

Stocks (3): stocks_get_quote stocks_get_chart stocks_search_symbol

Weather (1): get_weather

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

Chrome (12): chrome_list_tabs chrome_read_tab chrome_search_tabs chrome_navigate chrome_go_back chrome_setup_check chrome_evaluate_js chrome_click chrome_type chrome_fill_form chrome_wait_for chrome_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

Referral (2): create_referral_invites list_referral_candidates

System (12): lmcp_state get_config get_datetime daily_brief run_diagnostics get_audit_log lmcp_install_upgrade lmcp_upgrade_diagnostics report_problem request_feature report_friction run_terminal_command

Coming soon (not included in the 162 count above): Evernote (support is being rebuilt).

 

Safety

  • Email send/reply always shows a preview before sending — you confirm first
  • Calendar events require an explicit calendar name — never created in the wrong one
  • All destructive operations require confirmation
  • HTML email support via the html_body parameter

 

Privacy

Full policy: local-mcp.com/en/privacy.

  • What we collect from your apps: Nothing. Reading email, calendar, contacts, messages, files, and other Mac apps runs entirely on your machine — no email content, calendar events, contacts, messages, or file contents are ever transmitted to our servers or any third party. No API keys or accounts are required for your apps.
  • Anonymous telemetry: server/OS version, CPU architecture, uptime, a hashed machine ID, and tool-call counts (never content). No personal information included. Disable in LMCP Settings.
  • Optional cloud relay: opt-in and disabled by default. When enabled, MCP traffic you initiate passes through an encrypted WebSocket tunnel and is never stored; only the email used to associate the tunnel is retained.
  • Third-party sharing: none. Hosting/CDN providers (Railway, Cloudflare) never receive your personal Mac data.
  • Retention: heartbeats 90 days; install events 12 months (anonymized after); account records for their duration + 1 year; feedback until resolved or deleted on request.
  • Contact: privacy and data-rights requests — privacy@local-mcp.com.

 

Requirements

  • macOS 13 Ventura or later (Apple Silicon and Intel)
  • One of: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed

Config file locations

ClientPath
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

 

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 status

 

Uninstall

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

Stops all background processes, removes the LaunchAgent, deletes the app and binaries, and cleans up MCP config entries from every configured AI client. Your emails, calendar, and other data are never stored by LMCP and remain completely untouched.

 

Website · GitHub · Guides · Support: ctpo@colibird.co

Keywords

mcp

FAQs

Package last updated on 02 Aug 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts