local-mcp 1.141.0 → 2.0.0

package/README.md

@@ -1,16 +1,16 @@
 # local-mcp
 
-> MCP server for macOS — connect Claude Desktop, Cursor, Windsurf to Mail, Calendar, Contacts, Teams & OneDrive
+> Give your AI agent full control of your desktop apps. 80+ tools for Mail, Calendar, Notes, Reminders, Files, and more. Currently available for macOS, Windows coming soon.
 
 [![npm](https://img.shields.io/npm/v/local-mcp)](https://www.npmjs.com/package/local-mcp)
-[![platform](https://img.shields.io/badge/platform-macOS-blue)](https://local-mcp.com)
+[![platform](https://img.shields.io/badge/platform-macOS-blue)](https://local-mcp.com?utm_source=npm)
 
 **All data stays on your Mac.** No cloud. No tokens. No API keys.
 
 ## Install
 
 ```bash
-npm install -g local-mcp
+npx -y local-mcp@latest setup
 ```
 
 Auto-detects and configures Claude Desktop, Cursor, Windsurf, VS Code, and Zed. Restart your AI client once.
@@ -30,7 +30,7 @@ Auto-detects and configures Claude Desktop, Cursor, Windsurf, VS Code, and Zed.
 
 ## What it does
 
-Local MCP runs a native MCP server that bridges your Mac apps to any AI client:
+Pilot MCP runs a native MCP server that bridges your Mac apps to any AI client:
 
 | Service | Capabilities |
 |---------|-------------|
@@ -41,37 +41,45 @@ Local MCP runs a native MCP server that bridges your Mac apps to any AI client:
 | **OneDrive** | List, read, write, search, move, delete files |
 | **Documents** | Word, Excel, PowerPoint, PDF |
 | **Outlook** | Read, search, send emails, list/create calendar events (direct Outlook.app access) |
-| **Reminders** | List, create, complete reminders |
+| **Reminders & To Do** | List, create, complete — includes Microsoft To Do via sync |
+| **OmniFocus** | List tasks, projects, tags — create and complete tasks |
 | **Notes** | List, read, search, create notes |
-| **More** | Messages, Finder, Safari Bookmarks |
+| **Messages** | List chats, read and search iMessages |
+| **Stocks** | Real-time quotes, historical charts, symbol search |
+| **Finder** | Search and list files |
+| **Safari** | List bookmarks |
 
-## 62 MCP Tools
+## 82 MCP Tools
 
-Email: `list_accounts`, `list_emails`, `read_email`, `send_email`, `reply_email`, `search_emails`, `move_email`, `save_attachment`, `create_email_folder`
+Email: `list_accounts` `list_emails` `read_email` `send_email` `reply_email` `search_emails` `move_email` `save_attachment` `create_email_folder`
 
-Calendar: `list_calendar_names`, `list_calendar_events`, `create_calendar_event`, `delete_calendar_event`
+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`
+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`
+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`
+Documents: `word_create` `word_read` `word_append` `excel_create` `excel_read` `excel_write_cell` `ppt_create` `ppt_read` `pdf_read`
 
-Outlook: `outlook_list_emails`, `outlook_read_email`, `outlook_search_emails`, `outlook_send_email`, `outlook_list_events`, `outlook_create_event`
+Outlook: `outlook_list_emails` `outlook_read_email` `outlook_search_emails` `outlook_send_email` `outlook_list_events` `outlook_create_event`
 
-Reminders: `list_reminder_lists`, `list_reminders`, `create_reminder`, `complete_reminder`
+Reminders & To Do: `todo_list_lists` `todo_list_tasks` `todo_create_task` `todo_complete_task`
 
-Notes: `list_notes`, `read_note`, `search_notes`, `create_note`
+OmniFocus: `list_omnifocus_tasks` `list_omnifocus_projects` `list_omnifocus_tags` `search_omnifocus_tasks` `create_omnifocus_task` `complete_omnifocus_task`
 
-Messages: `list_message_chats`, `read_messages`, `search_messages`
+Notes: `list_notes` `read_note` `search_notes` `create_note`
 
-Finder: `finder_search`, `finder_list`
+Messages: `list_message_chats` `read_messages` `search_messages`
+
+Stocks: `stocks_get_quote` `stocks_get_chart` `stocks_search_symbol`
+
+Finder: `finder_search` `finder_list`
 
 Safari: `list_safari_bookmarks`
 
-Utilities: `diagnose`, `report_bug`, `request_feature`, `send_logs`, `lmcp_help`, `list_my_feedback`, `close_feedback`
+Utilities: `diagnose` `version_info` `report_bug` `request_feature` `send_logs` `lmcp_help` `list_my_feedback` `close_feedback`
 
 ## Safety
 
@@ -98,15 +106,14 @@ Utilities: `diagnose`, `report_bug`, `request_feature`, `send_logs`, `lmcp_help`
 ## Commands
 
 ```bash
-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 status
+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
 ```
 
 ## Full app (optional)
 
-For the menu bar status icon, auto-start, and Cloud Relay:
+For the menu bar status icon, auto-start on login, and Cloud Relay:
 
 ```bash
 curl -fsSL https://local-mcp.com/install | bash
@@ -114,7 +121,6 @@ curl -fsSL https://local-mcp.com/install | bash
 
 ## Links
 
-- [Website](https://local-mcp.com)
-- [npm](https://www.npmjs.com/package/local-mcp)
-- [Pricing](https://local-mcp.com/#pricing)
+- [Website](https://local-mcp.com?utm_source=npm)
+- [Pricing](https://local-mcp.com/#pricing?utm_source=npm)
 - Support: support@local-mcp.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-mcp",
-  "version": "1.141.0",
+  "version": "2.0.0",
   "description": "MCP server for macOS — connect Claude Desktop, Cursor, Windsurf to Mail, Calendar, Contacts, Teams, OneDrive. Privacy-first: all data stays on your Mac.",
   "main": "index.js",
   "bin": {
@@ -70,5 +70,5 @@
   "bugs": {
     "url": "https://github.com/lanchuske/local-mcp/issues"
   },
-  "mcpName": "io.github.lanchuske/local-mcp"
+  "mcpName": "com.local-mcp/local-mcp"
 }

package/setup.js

@@ -16,6 +16,7 @@ const { execSync, execFileSync } = require('child_process')
 const HOME = os.homedir()
 const NPX_COMMAND = 'npx'
 const NPX_ARGS    = ['-y', 'local-mcp@latest']
+const STABLE_LINK = path.join(os.homedir(), '.local', 'share', 'local-mcp', 'bin', 'local-mcp-server')
 
 // ── Rutas de config de cada cliente ──────────────────────────────────────────
 
@@ -79,24 +80,23 @@ function _writeJson(filePath, data) {
 
 // ── Inyectar config MCP en un cliente estándar ────────────────────────────────
 
-function injectMcpConfig(client) {
+function injectMcpConfig(client, command = NPX_COMMAND, args = NPX_ARGS) {
   const cfg = _readJson(client.cfgPath)
 
   if (client.zed) {
     // Zed usa { "context_servers": { "local-mcp": { "command": {...} } } }
     cfg.context_servers = cfg.context_servers || {}
     cfg.context_servers['local-mcp'] = {
-      command: { path: NPX_COMMAND, args: NPX_ARGS },
+      command: { path: command, args: args ?? [] },
     }
   } else {
-    // Formato estándar MCP: { "mcpServers": { "local-mcp": { "command": "npx", "args": [...] } } }
+    // Formato estándar MCP: { "mcpServers": { "local-mcp": { "command": "...", "args": [...] } } }
     cfg.mcpServers = cfg.mcpServers || {}
     // Limpiar entradas legacy
     delete cfg.mcpServers['office-mcp']
-    cfg.mcpServers['local-mcp'] = {
-      command: NPX_COMMAND,
-      args:    NPX_ARGS,
-    }
+    const entry = { command }
+    if (args !== undefined) entry.args = args
+    cfg.mcpServers['local-mcp'] = entry
   }
 
   _writeJson(client.cfgPath, cfg)
@@ -112,6 +112,29 @@ async function runSetup(opts = {}) {
   console.log('║     Local MCP — Setup Wizard         ║')
   console.log('╚══════════════════════════════════════╝\n')
 
+  // Descargar el binario ahora para poder escribir el stable link en la config
+  // Esto elimina el 2do reinicio que de otro modo sería necesario para migrar npx → binario
+  let stableCommand = NPX_COMMAND
+  let stableArgs    = NPX_ARGS
+  try {
+    const { ensureBinary, CACHE_DIR } = require('./download')
+    process.stderr.write('Downloading Local MCP runtime...\n')
+    const { binPath } = await ensureBinary()
+    // Crear stable symlink
+    const stableLink = path.join(CACHE_DIR, 'local-mcp-server')
+    try {
+      if (fs.existsSync(stableLink)) fs.unlinkSync(stableLink)
+      fs.symlinkSync(binPath, stableLink)
+    } catch { /* no crítico — fallback a npx */ }
+    if (fs.existsSync(stableLink)) {
+      stableCommand = stableLink
+      stableArgs    = undefined
+      process.stderr.write('✓ Runtime ready\n\n')
+    }
+  } catch (err) {
+    process.stderr.write(`  (Runtime download failed, will download on first run: ${err.message})\n\n`)
+  }
+
   // Detectar clientes
   const detected = CLIENTS.filter(c => c.detect())
 
@@ -119,7 +142,10 @@ async function runSetup(opts = {}) {
     console.log('No AI clients detected.')
     console.log('Install Claude Desktop, Cursor, Windsurf, or VS Code and run this command again.\n')
     console.log('Or add this manually to your AI client config:')
-    console.log(JSON.stringify({ mcpServers: { 'local-mcp': { command: NPX_COMMAND, args: NPX_ARGS } } }, null, 2))
+    const manualEntry = stableArgs !== undefined
+      ? { command: stableCommand, args: stableArgs }
+      : { command: stableCommand }
+    console.log(JSON.stringify({ mcpServers: { 'local-mcp': manualEntry } }, null, 2))
     return
   }
 
@@ -130,7 +156,7 @@ async function runSetup(opts = {}) {
 
   for (const client of detected) {
     try {
-      injectMcpConfig(client)
+      injectMcpConfig(client, stableCommand, stableArgs)
       configured.push(client.name)
       console.log(`✓ ${client.name} configured`)
     } catch (err) {
@@ -234,6 +260,7 @@ function _pingInstall(clients, method) {
       method: method,
       clients_configured: clients,
       machine_id: _getMachineId(),
+      source: process.env.LMCP_SOURCE || '',
     })
     const req = https.request({
       hostname: 'office-mcp-production.up.railway.app',