local-mcp 3.0.304 → 3.0.306
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -40
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,30 +1,29 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Local MCP
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> Native macOS access for your AI assistant — 161 local tools across Mail, Calendar, Contacts, Messages, Teams, Slack, WhatsApp, OneDrive, Google Drive, Microsoft 365, Notes, Reminders, OmniFocus, Safari, Word/Excel/PowerPoint, and more. Everything runs locally. Your data never leaves your machine.
|
|
4
4
|
|
|
5
|
-
[](https://www.npmjs.com/package/local-mcp)
|
|
6
|
-
[](https://www.npmjs.com/package/local-mcp)
|
|
6
|
+
[](https://local-mcp.com?ref=npm)
|
|
7
|
+
[](https://local-mcp.com?ref=npm)
|
|
8
|
+
[](https://local-mcp.com/en/privacy)
|
|
8
9
|
|
|
9
10
|
**No cloud. No tokens. No API keys. 100% free.**
|
|
10
11
|
|
|
12
|
+
|
|
13
|
+
|
|
11
14
|
## Install
|
|
12
15
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
+
| Method | | Best for |
|
|
17
|
+
|---|---|---|
|
|
18
|
+
| **Installer** | [Download `LMCP-Installer.pkg`](https://download.local-mcp.com/LMCP-Installer.pkg) | Most users and managed fleets (MDM-deployable) |
|
|
19
|
+
| **Terminal** | `curl -fsSL 'https://local-mcp.com/install?ref=npm' \| bash` | One-line setup |
|
|
20
|
+
| **npx** | `npx -y local-mcp@latest setup` | Configuring AI clients from an existing Node environment |
|
|
16
21
|
|
|
17
|
-
Auto-detects and configures
|
|
22
|
+
Auto-detects and configures Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, and Zed. Restart your AI client once.
|
|
18
23
|
|
|
19
24
|
> **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.
|
|
20
25
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
npx -y local-mcp@latest setup
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## MCP config (manual)
|
|
26
|
+
### MCP config (manual)
|
|
28
27
|
|
|
29
28
|
```json
|
|
30
29
|
{
|
|
@@ -37,6 +36,8 @@ npx -y local-mcp@latest setup
|
|
|
37
36
|
}
|
|
38
37
|
```
|
|
39
38
|
|
|
39
|
+
|
|
40
|
+
|
|
40
41
|
## What it does
|
|
41
42
|
|
|
42
43
|
LMCP runs a native MCP server that bridges your Mac apps to any AI client:
|
|
@@ -59,7 +60,7 @@ LMCP runs a native MCP server that bridges your Mac apps to any AI client:
|
|
|
59
60
|
| **To Do** | Microsoft To Do tasks (synced via macOS Reminders) |
|
|
60
61
|
| **OmniFocus** | List tasks, projects, tags — create and complete tasks |
|
|
61
62
|
| **Notes** | List, read, search, create notes |
|
|
62
|
-
| **Messages** | List chats, read and
|
|
63
|
+
| **Messages** | List chats, read, search, and send iMessages |
|
|
63
64
|
| **Stocks** | Real-time quotes, historical charts, symbol search |
|
|
64
65
|
| **Finder** | Search files via Spotlight, list directory contents |
|
|
65
66
|
| **Safari** | Bookmarks, open tabs, click/type/fill forms, run JavaScript |
|
|
@@ -68,7 +69,9 @@ LMCP runs a native MCP server that bridges your Mac apps to any AI client:
|
|
|
68
69
|
| **NordVPN** | Status, server recommendations, diagnostics |
|
|
69
70
|
| **Image Playground** | Generate images on-device from a text prompt — Apple Intelligence, no cloud, no API key (requires macOS 15.4+) |
|
|
70
71
|
|
|
71
|
-
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
## All 161 tools (macOS)
|
|
72
75
|
|
|
73
76
|
Email (11): `list_accounts` `list_email_accounts` `list_emails` `read_email` `send_email` `reply_email` `search_emails` `move_email` `save_attachment` `create_email_folder` `list_email_folders`
|
|
74
77
|
|
|
@@ -84,7 +87,6 @@ WhatsApp (5): `whatsapp_list_chats` `whatsapp_read_messages` `whatsapp_search_me
|
|
|
84
87
|
|
|
85
88
|
Signal (3): `signal_list_chats` `signal_read_messages` `signal_search_messages`
|
|
86
89
|
|
|
87
|
-
|
|
88
90
|
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`
|
|
89
91
|
|
|
90
92
|
Google Drive (6): `gdrive_root` `gdrive_list_files` `gdrive_read_file` `gdrive_write_file` `gdrive_search_files` `gdrive_file_info`
|
|
@@ -107,7 +109,7 @@ OmniFocus (7): `list_omnifocus_tasks` `list_omnifocus_projects` `list_omnifocus_
|
|
|
107
109
|
|
|
108
110
|
Notes (5): `list_notes` `read_note` `search_notes` `create_note` `update_note`
|
|
109
111
|
|
|
110
|
-
Messages (
|
|
112
|
+
Messages (4): `list_message_chats` `read_messages` `search_messages` `send_message`
|
|
111
113
|
|
|
112
114
|
Stocks (3): `stocks_get_quote` `stocks_get_chart` `stocks_search_symbol`
|
|
113
115
|
|
|
@@ -125,16 +127,20 @@ Referral (2): `create_referral_invites` `list_referral_candidates`
|
|
|
125
127
|
|
|
126
128
|
System (11): `lmcp_state` `get_config` `get_datetime` `daily_brief` `run_diagnostics` `get_audit_log` `update_local_mcp` `update_self_diagnosis` `report_problem` `request_feature` `signal_friction`
|
|
127
129
|
|
|
128
|
-
_Coming soon (not included in the
|
|
130
|
+
_Coming soon (not included in the 161 count above): **Evernote** (support is being rebuilt)._
|
|
131
|
+
|
|
132
|
+
|
|
129
133
|
|
|
130
134
|
## Safety
|
|
131
135
|
|
|
132
136
|
- Email send/reply always shows a preview before sending — you confirm first
|
|
133
|
-
- Calendar events require explicit calendar name — never
|
|
137
|
+
- Calendar events require an explicit calendar name — never created in the wrong one
|
|
134
138
|
- All destructive operations require confirmation
|
|
135
|
-
- HTML email support via `html_body` parameter
|
|
139
|
+
- HTML email support via the `html_body` parameter
|
|
140
|
+
|
|
141
|
+
|
|
136
142
|
|
|
137
|
-
## Privacy
|
|
143
|
+
## Privacy
|
|
138
144
|
|
|
139
145
|
Full policy: **[local-mcp.com/en/privacy](https://local-mcp.com/en/privacy)**.
|
|
140
146
|
|
|
@@ -145,12 +151,14 @@ Full policy: **[local-mcp.com/en/privacy](https://local-mcp.com/en/privacy)**.
|
|
|
145
151
|
- **Retention:** heartbeats 90 days; install events 12 months (anonymized after); account records for their duration + 1 year; feedback until resolved or deleted on request.
|
|
146
152
|
- **Contact:** privacy and data-rights requests — [privacy@local-mcp.com](mailto:privacy@local-mcp.com).
|
|
147
153
|
|
|
154
|
+
|
|
155
|
+
|
|
148
156
|
## Requirements
|
|
149
157
|
|
|
150
158
|
- macOS 13 Ventura or later (Apple Silicon and Intel)
|
|
151
159
|
- One of: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed
|
|
152
160
|
|
|
153
|
-
|
|
161
|
+
### Config file locations
|
|
154
162
|
|
|
155
163
|
| Client | Path |
|
|
156
164
|
|--------|------|
|
|
@@ -161,9 +169,7 @@ Full policy: **[local-mcp.com/en/privacy](https://local-mcp.com/en/privacy)**.
|
|
|
161
169
|
| VS Code | `~/.vscode/mcp.json` |
|
|
162
170
|
| Zed | `~/.config/zed/settings.json` |
|
|
163
171
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
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.
|
|
172
|
+
|
|
167
173
|
|
|
168
174
|
## Commands
|
|
169
175
|
|
|
@@ -173,13 +179,7 @@ npx -y local-mcp@latest update # force re-download of the runtime
|
|
|
173
179
|
npx -y local-mcp@latest status # show server status
|
|
174
180
|
```
|
|
175
181
|
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
For the menu bar status icon, auto-start on login, and Cloud Relay:
|
|
179
|
-
|
|
180
|
-
```bash
|
|
181
|
-
curl -fsSL 'https://local-mcp.com/install?ref=npm' | bash
|
|
182
|
-
```
|
|
182
|
+
|
|
183
183
|
|
|
184
184
|
## Uninstall
|
|
185
185
|
|
|
@@ -187,11 +187,10 @@ curl -fsSL 'https://local-mcp.com/install?ref=npm' | bash
|
|
|
187
187
|
curl -fsSL 'https://local-mcp.com/uninstall' | bash
|
|
188
188
|
```
|
|
189
189
|
|
|
190
|
-
Stops all background processes, removes the LaunchAgent, deletes the app and binaries, and cleans up MCP config entries from
|
|
190
|
+
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.
|
|
191
|
+
|
|
192
|
+
|
|
191
193
|
|
|
192
194
|
## Links
|
|
193
195
|
|
|
194
|
-
|
|
195
|
-
- [GitHub](https://github.com/lanchuske/local-mcp-releases)
|
|
196
|
-
- [Guides](https://local-mcp.com/guides)
|
|
197
|
-
- Support: ctpo@colibird.co
|
|
196
|
+
[Website](https://local-mcp.com?ref=npm) · [GitHub](https://github.com/lanchuske/local-mcp-releases) · [Guides](https://local-mcp.com/guides) · Support: ctpo@colibird.co
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "local-mcp",
|
|
3
|
-
"version": "3.0.
|
|
3
|
+
"version": "3.0.306",
|
|
4
4
|
"description": "LMCP — connect Claude Desktop, Cursor, Windsurf to Mail, Calendar, Contacts, Teams, OneDrive on macOS. Privacy-first: all data stays on your Mac.",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|