local-mcp 1.63.0 → 1.65.0

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.
Files changed (2) hide show
  1. package/README.md +54 -59
  2. package/package.json +28 -4
package/README.md CHANGED
@@ -1,8 +1,11 @@
1
1
  # local-mcp
2
2
 
3
- **Connect Claude Desktop, Cursor, Windsurf, VS Code and other AI agents to Mail, Calendar, Contacts, Microsoft Teams and OneDrive on Mac.**
3
+ > MCP server for macOS — connect Claude Desktop, Cursor, Windsurf to Mail, Calendar, Contacts, Teams & OneDrive
4
4
 
5
- No cloud. No tokens. No API keys. Your data never leaves your machine.
5
+ [![npm](https://img.shields.io/npm/v/local-mcp)](https://www.npmjs.com/package/local-mcp)
6
+ [![platform](https://img.shields.io/badge/platform-macOS-blue)](https://local-mcp.com)
7
+
8
+ **All data stays on your Mac.** No cloud. No tokens. No API keys.
6
9
 
7
10
  ## Install
8
11
 
@@ -10,11 +13,9 @@ No cloud. No tokens. No API keys. Your data never leaves your machine.
10
13
  npm install -g local-mcp
11
14
  ```
12
15
 
13
- Auto-detects and configures all your AI clients. Restart your AI client once — done.
14
-
15
- ## Zero-install (Claude Desktop / Cursor / Windsurf / VS Code)
16
+ Auto-detects and configures Claude Desktop, Cursor, Windsurf, VS Code, and Zed. Restart your AI client once.
16
17
 
17
- Add directly to your MCP config file and restart:
18
+ ## Or add directly to your MCP config
18
19
 
19
20
  ```json
20
21
  {
@@ -27,75 +28,54 @@ Add directly to your MCP config file and restart:
27
28
  }
28
29
  ```
29
30
 
30
- Config file locations:
31
- - **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json`
32
- - **Cursor**: `~/.cursor/mcp.json`
33
- - **Windsurf**: `~/.codeium/windsurf/mcp_config.json`
34
- - **VS Code (Cline)**: `~/.vscode/mcp.json`
35
- - **Zed**: `~/.config/zed/settings.json`
36
-
37
- ## Setup wizard
38
-
39
- ```bash
40
- local-mcp setup
41
- ```
42
-
43
- Detects all installed clients and writes the config automatically.
44
-
45
31
  ## What it does
46
32
 
47
- Local MCP runs a native MCP (Model Context Protocol) server that bridges your Mac apps directly to your AI client:
33
+ Local MCP runs a native MCP server that bridges your Mac apps to any AI client:
48
34
 
49
- | Module | Tools |
50
- |--------|-------|
51
- | **Email** | list, read, search, send, reply, move (via Mail.app) |
52
- | **Calendar** | list events, create events (via Calendar.app) |
53
- | **Contacts** | search, list (via Contacts.app) |
54
- | **Teams** | read chats, channels, messages (no tokens — reads local cache) |
55
- | **OneDrive** | list, read, write, search, move, delete files |
56
- | **Word** | read, create, append documents |
57
- | **Excel** | read, write cells, create spreadsheets |
58
- | **PowerPoint** | read, create presentations |
59
- | **PDF** | extract text |
35
+ | Service | Capabilities |
36
+ |---------|-------------|
37
+ | **Mail** | Read, search, send, reply — Gmail, Outlook, iCloud, Exchange |
38
+ | **Calendar** | List, create, delete events across all accounts |
39
+ | **Contacts** | Search and list from Contacts.app |
40
+ | **Teams** | Read chats, channels, messages (no tokens needed) |
41
+ | **OneDrive** | List, read, write, search, move, delete files |
42
+ | **Documents** | Word, Excel, PowerPoint, PDF |
60
43
 
61
- ## Requirements
62
-
63
- - macOS 12 Monterey or later (Apple Silicon and Intel)
64
- - Node.js 18+
65
- - The AI client you want to use (Claude Desktop, Cursor, Windsurf, etc.)
44
+ ## 38 MCP Tools
66
45
 
67
- ## How it works
46
+ Email: `list_accounts`, `list_emails`, `read_email`, `send_email`, `reply_email`, `search_emails`, `move_email`, `save_attachment`
68
47
 
69
- 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.
48
+ Calendar: `list_calendar_names`, `list_calendar_events`, `create_calendar_event`, `delete_calendar_event`
70
49
 
71
- For the full experience with menu bar status icon and auto-start:
50
+ Contacts: `list_contacts`
72
51
 
73
- ```bash
74
- curl -fsSL https://local-mcp.com/install | bash
75
- ```
52
+ Teams: `teams_list_teams`, `teams_list_channels`, `teams_list_chats`, `teams_read_channel_messages`, `teams_read_chat_messages`
76
53
 
77
- ## Claude.ai web connector
54
+ OneDrive: `onedrive_root`, `onedrive_list_files`, `onedrive_read_file`, `onedrive_write_file`, `onedrive_move_file`, `onedrive_delete_file`, `onedrive_search_files`
78
55
 
79
- For Claude.ai (web), add a custom connector:
56
+ Documents: `word_create`, `word_read`, `word_append`, `excel_create`, `excel_read`, `excel_write_cell`, `ppt_create`, `ppt_read`, `pdf_read`
80
57
 
81
- ```
82
- URL: https://www.local-mcp.com/mcp
83
- ```
58
+ ## Safety
84
59
 
85
- Settings → Connectors → Add custom connector → paste the URL.
60
+ - Email send/reply always shows a preview before sending — you confirm first
61
+ - Calendar events require explicit calendar name — never creates in the wrong one
62
+ - All destructive operations require confirmation
86
63
 
87
- ## Privacy & Security
64
+ ## Requirements
88
65
 
89
- - All data stays on your Mac — no cloud processing
90
- - Teams integration reads local IndexedDB cache — no Graph API, no OAuth
91
- - Unique API key per installation
92
- - 14-day free trial, no credit card
66
+ - macOS 12 Monterey or later (Apple Silicon and Intel)
67
+ - Node.js 18+
68
+ - One of: Claude Desktop, Cursor, Windsurf, VS Code, Zed
93
69
 
94
- ## Links
70
+ ## Config file locations
95
71
 
96
- - **Website**: https://local-mcp.com
97
- - **Pricing**: https://local-mcp.com/#pricing
98
- - **Support**: support@local-mcp.com
72
+ | Client | Path |
73
+ |--------|------|
74
+ | Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |
75
+ | Cursor | `~/.cursor/mcp.json` |
76
+ | Windsurf | `~/.codeium/windsurf/mcp_config.json` |
77
+ | VS Code | `~/.vscode/mcp.json` |
78
+ | Zed | `~/.config/zed/settings.json` |
99
79
 
100
80
  ## Commands
101
81
 
@@ -105,3 +85,18 @@ local-mcp update # force re-download of the runtime
105
85
  local-mcp uninstall # remove cached runtime
106
86
  local-mcp status # show server status
107
87
  ```
88
+
89
+ ## Full app (optional)
90
+
91
+ For the menu bar status icon, auto-start, and Cloud Relay:
92
+
93
+ ```bash
94
+ curl -fsSL https://local-mcp.com/install | bash
95
+ ```
96
+
97
+ ## Links
98
+
99
+ - [Website](https://local-mcp.com)
100
+ - [npm](https://www.npmjs.com/package/local-mcp)
101
+ - [Pricing](https://local-mcp.com/#pricing)
102
+ - Support: support@local-mcp.com
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "local-mcp",
3
- "version": "1.63.0",
4
- "description": "Connect Claude, Cursor, Windsurf and other AI agents to Mail, Calendar, Contacts, Teams and OneDrive on Mac \u2014 no cloud, no tokens",
3
+ "version": "1.65.0",
4
+ "description": "MCP server for macOS \u2014 connect Claude Desktop, Cursor, Windsurf to Mail, Calendar, Contacts, Teams, OneDrive. Privacy-first: all data stays on your Mac.",
5
5
  "main": "index.js",
6
6
  "bin": {
7
7
  "local-mcp": "index.js"
@@ -25,17 +25,40 @@
25
25
  "keywords": [
26
26
  "mcp",
27
27
  "model-context-protocol",
28
+ "mcp-server",
28
29
  "claude",
30
+ "claude-desktop",
29
31
  "cursor",
30
32
  "windsurf",
33
+ "vscode",
34
+ "zed",
31
35
  "ai",
36
+ "ai-agent",
37
+ "ai-tools",
32
38
  "macos",
39
+ "mac",
40
+ "apple",
33
41
  "mail",
42
+ "email",
43
+ "gmail",
44
+ "outlook",
45
+ "exchange",
46
+ "icloud",
34
47
  "calendar",
35
48
  "contacts",
36
49
  "teams",
50
+ "microsoft-teams",
37
51
  "onedrive",
38
- "local"
52
+ "word",
53
+ "excel",
54
+ "powerpoint",
55
+ "pdf",
56
+ "local",
57
+ "privacy",
58
+ "offline",
59
+ "no-cloud",
60
+ "productivity",
61
+ "automation"
39
62
  ],
40
63
  "author": "Local MCP <hello@local-mcp.com>",
41
64
  "license": "SEE LICENSE IN LICENSE",
@@ -46,5 +69,6 @@
46
69
  },
47
70
  "bugs": {
48
71
  "url": "https://github.com/lanchuske/local-mcp/issues"
49
- }
72
+ },
73
+ "mcpName": "io.github.lanchuske/local-mcp"
50
74
  }