screenpipe-mcp 0.18.14 → 0.18.15

package/README.md

@@ -148,7 +148,7 @@ Get a lightweight compressed activity overview for a time range:
 - Audio speaker summary
 
 ### list-meetings
-List detected meetings with duration, app, and attendees. Pass `q` to filter by substring (title, attendees, notes).
+List detected meetings with id, duration, app, attendees, and note snippet. Pass `q` to filter by substring (title, attendees, notes) — `q` searches all meeting history, so omit the time range when looking for a person or topic. Follow up with `get-meeting` (optionally `include_transcript: true`) for the full note and speaker-attributed transcript.
 
 ### search-elements
 Search structured UI elements (accessibility tree nodes and OCR text blocks):
@@ -190,8 +190,9 @@ Get accessibility text, parsed tree nodes, and extracted URLs for a specific fra
 ## Privacy Policy
 
 The Screenpipe MCP server is a local-only bridge between Claude and your
-local Screenpipe instance. It does not collect, transmit, or store any
-data on its own.
+local Screenpipe instance. It does not collect, transmit, or store tool
+results, recordings, OCR text, audio transcripts, screenshots, or UI events
+on its own.
 
 ### What this MCP server does
 When Claude invokes a tool (`search-content`, `activity-summary`, etc.)
@@ -200,7 +201,16 @@ Screenpipe daemon running on your machine — and returns the response.
 That's the entire data path.
 
 ### Data collection
-**None by this MCP server.** No analytics, no telemetry, no usage tracking.
+The MCP server sends privacy-preserving crash and error reports to Screenpipe's
+Sentry project so we can diagnose startup failures like "server disconnected"
+or "could not attach to MCP server". These reports include the MCP package
+version, runtime, transport mode, and sanitized exception details. They do not
+include tool arguments, tool results, screen content, audio, transcripts,
+screenshots, API tokens, or your home-directory path.
+
+To disable crash/error reporting, set any of:
+`SCREENPIPE_MCP_SENTRY_DISABLED=1`, `SCREENPIPE_TELEMETRY_DISABLED=1`, or
+`SCREENPIPE_DISABLE_TELEMETRY=1` in the MCP launch environment.
 
 ### Data usage
 Tool calls are passed straight through to your local Screenpipe daemon
@@ -215,8 +225,9 @@ whatever you configure inside the Screenpipe app — typically you
 control it via the storage settings panel.
 
 ### Third-party sharing
-None. The MCP server only talks to `localhost:3030`. It does not
-contact Anthropic, Screenpipe's servers, or any other external service.
+The MCP server talks to `localhost:3030` for tool calls and to Screenpipe's
+Sentry project for sanitized crash/error reports unless disabled as above.
+It does not contact Anthropic or send recorded content to Screenpipe's servers.
 If you choose to enable optional cloud features inside the Screenpipe
 app itself (e.g. cloud sync, cloud AI), those are governed by the
 Screenpipe app's privacy policy, not this MCP server's data flow.

package/bun.lock

@@ -6,6 +6,7 @@
       "name": "screenpipe-mcp",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.27.1",
+        "@sentry/node": "^10.64.0",
       },
       "devDependencies": {
         "@types/node": "^25.3.5",
@@ -16,6 +17,12 @@
     },
   },
   "packages": {
+    "@apm-js-collab/code-transformer": ["@apm-js-collab/code-transformer@0.15.0", "", { "dependencies": { "@types/estree": "^1.0.8", "astring": "^1.9.0", "esquery": "^1.7.0", "meriyah": "^6.1.4", "semifies": "^1.0.0", "source-map": "^0.6.0" }, "bin": { "code-transformer": "cli.js" } }, "sha512-XmXYVs8CzJ1Aj79noVbn2weUO/XWtRyURpGqx7aU7DOXlUQhR0WKOQNF0okh7PCeY37vxf7kU3v57OAkEPm3ww=="],
+
+    "@apm-js-collab/code-transformer-bundler-plugins": ["@apm-js-collab/code-transformer-bundler-plugins@0.5.0", "", { "dependencies": { "@apm-js-collab/code-transformer": "^0.15.0", "es-module-lexer": "^2.1.0", "magic-string": "^0.30.21", "module-details-from-path": "^1.0.4" } }, "sha512-YxLBY5nGlurL7QeJLq6e5g0ouBpAp0pwgyA/5rHXEXwhiPLn9ZHbT+Y2LlP90GT872cSocfjWRYu/fnpuBudNQ=="],
+
+    "@apm-js-collab/tracing-hooks": ["@apm-js-collab/tracing-hooks@0.10.1", "", { "dependencies": { "@apm-js-collab/code-transformer": "^0.15.0", "debug": "^4.4.1", "module-details-from-path": "^1.0.4" } }, "sha512-w2OWXR7FWrKqSziuE9+QclaZrStxO/8+OwbXM635s/zs0Eez1Qo3ivSPdB2WsaPY/iznKTytONPx/PitD7IXcA=="],
+
     "@cspotcode/source-map-support": ["@cspotcode/source-map-support@0.8.1", "", { "dependencies": { "@jridgewell/trace-mapping": "0.3.9" } }, "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw=="],
 
     "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.27.3", "", { "os": "aix", "cpu": "ppc64" }, "sha512-9fJMTNFTWZMh5qwrBItuziu834eOCUcEqymSH7pY+zoMVEZg3gcPuBNxH1EvfVYe9h0x/Ptw8KBzv7qxb7l8dg=="],
@@ -80,6 +87,22 @@
 
     "@modelcontextprotocol/sdk": ["@modelcontextprotocol/sdk@1.27.1", "", { "dependencies": { "@hono/node-server": "^1.19.9", "ajv": "^8.17.1", "ajv-formats": "^3.0.1", "content-type": "^1.0.5", "cors": "^2.8.5", "cross-spawn": "^7.0.5", "eventsource": "^3.0.2", "eventsource-parser": "^3.0.0", "express": "^5.2.1", "express-rate-limit": "^8.2.1", "hono": "^4.11.4", "jose": "^6.1.3", "json-schema-typed": "^8.0.2", "pkce-challenge": "^5.0.0", "raw-body": "^3.0.0", "zod": "^3.25 || ^4.0", "zod-to-json-schema": "^3.25.1" }, "peerDependencies": { "@cfworker/json-schema": "^4.1.1" }, "optionalPeers": ["@cfworker/json-schema"] }, "sha512-sr6GbP+4edBwFndLbM60gf07z0FQ79gaExpnsjMGePXqFcSSb7t6iscpjk9DhFhwd+mTEQrzNafGP8/iGGFYaA=="],
 
+    "@opentelemetry/api": ["@opentelemetry/api@1.9.1", "", {}, "sha512-gLyJlPHPZYdAk1JENA9LeHejZe1Ti77/pTeFm/nMXmQH/HFZlcS/O2XJB+L8fkbrNSqhdtlvjBVjxwUYanNH5Q=="],
+
+    "@opentelemetry/api-logs": ["@opentelemetry/api-logs@0.220.0", "", { "dependencies": { "@opentelemetry/api": "^1.3.0" } }, "sha512-CmVa4ImJ+ynfrPMNaAXHET6Bhb44SwzmfyVJFq9ni2jgXJR/l7C6gfVFddNmHP+ZOkP9cf4f9DBe68qVLTHc9w=="],
+
+    "@opentelemetry/core": ["@opentelemetry/core@2.9.0", "", { "dependencies": { "@opentelemetry/semantic-conventions": "^1.29.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.0.0 <1.10.0" } }, "sha512-m2nckMT80NnmjTYSPjJQObBJ+8dgkoajEOUbznL8AHZ3T3yHRk2P7gI1PhEBc1+lOnrYE9UWrWHqJDsmqjmNbw=="],
+
+    "@opentelemetry/instrumentation": ["@opentelemetry/instrumentation@0.220.0", "", { "dependencies": { "@opentelemetry/api-logs": "0.220.0", "import-in-the-middle": "^3.0.0", "require-in-the-middle": "^8.0.0" }, "peerDependencies": { "@opentelemetry/api": "^1.3.0" } }, "sha512-xQx3E2WxP1mDvKzxLxX+CTCtNLa560YJZ3087qYHerl2YmiKpv7AH+dAy7vmx+eVrZ5BwhfWUAVoKOoxCNHcpw=="],
+
+    "@opentelemetry/resources": ["@opentelemetry/resources@2.9.0", "", { "dependencies": { "@opentelemetry/core": "2.9.0", "@opentelemetry/semantic-conventions": "^1.29.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.3.0 <1.10.0" } }, "sha512-jyA5MBLQ+Dkl3+JsZkUoUvL7yHvU64kLsvpXKarWm6347Sl1t1bXFTFykUePNpT5WH5pm9a2Qtt03iIYQhZ1Fg=="],
+
+    "@opentelemetry/sdk-trace": ["@opentelemetry/sdk-trace@2.9.0", "", { "dependencies": { "@opentelemetry/core": "2.9.0", "@opentelemetry/resources": "2.9.0", "@opentelemetry/semantic-conventions": "^1.29.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.3.0 <1.10.0" } }, "sha512-sGA19HvtrrSKYsseHphluH6j3p6Xa3fqc7c7y8f/7mYWejc1lyDFcpSdD1kYa50HCLUeEo4zA5bW0pniaPszuw=="],
+
+    "@opentelemetry/sdk-trace-base": ["@opentelemetry/sdk-trace-base@2.9.0", "", { "dependencies": { "@opentelemetry/core": "2.9.0", "@opentelemetry/resources": "2.9.0", "@opentelemetry/sdk-trace": "2.9.0", "@opentelemetry/semantic-conventions": "^1.29.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.3.0 <1.10.0" } }, "sha512-cp9zmTl62R8PJrpvFcmc8N2JQU/xfa0S+61q511Nji+QxCfZ8Ifvg7H27G8cANe4crg4RTrWsVvanHiXjSp6ag=="],
+
+    "@opentelemetry/semantic-conventions": ["@opentelemetry/semantic-conventions@1.42.0", "", {}, "sha512-icc5xCzndZfhuJMy5oqk5AvloWquR7jtae74qzpkKkhGp8BivK+oCcEXgGnjCdTfp8hA44l+w8gE8yYJbocJJw=="],
+
     "@rollup/rollup-android-arm-eabi": ["@rollup/rollup-android-arm-eabi@4.56.0", "", { "os": "android", "cpu": "arm" }, "sha512-LNKIPA5k8PF1+jAFomGe3qN3bbIgJe/IlpDBwuVjrDKrJhVWywgnJvflMt/zkbVNLFtF1+94SljYQS6e99klnw=="],
 
     "@rollup/rollup-android-arm64": ["@rollup/rollup-android-arm64@4.56.0", "", { "os": "android", "cpu": "arm64" }, "sha512-lfbVUbelYqXlYiU/HApNMJzT1E87UPGvzveGg2h0ktUNlOCxKlWuJ9jtfvs1sKHdwU4fzY7Pl8sAl49/XaEk6Q=="],
@@ -130,6 +153,18 @@
 
     "@rollup/rollup-win32-x64-msvc": ["@rollup/rollup-win32-x64-msvc@4.56.0", "", { "os": "win32", "cpu": "x64" }, "sha512-H8AE9Ur/t0+1VXujj90w0HrSOuv0Nq9r1vSZF2t5km20NTfosQsGGUXDaKdQZzwuLts7IyL1fYT4hM95TI9c4g=="],
 
+    "@sentry/conventions": ["@sentry/conventions@0.15.1", "", {}, "sha512-ZLP8bRdMON3prWE2tJyImuYscCxdcJeIPIhrOs/rgyFm3C1nCh1B6gdvPj3AZ5zW08oSFFCsq7T+tYEW3h8MNA=="],
+
+    "@sentry/core": ["@sentry/core@10.64.0", "", { "dependencies": { "@sentry/conventions": "^0.15.1" } }, "sha512-HjojJcXD1l2qZ1AXje2s0XY/nYsaUt00wsM1HMBImA8vAClyPisFE/CC0/UD6pEvsGFhVgi8Dcxo7EN41uyeFw=="],
+
+    "@sentry/node": ["@sentry/node@10.64.0", "", { "dependencies": { "@opentelemetry/api": "^1.9.1", "@opentelemetry/instrumentation": "^0.220.0", "@opentelemetry/sdk-trace-base": "^2.9.0", "@sentry/conventions": "^0.15.1", "@sentry/core": "10.64.0", "@sentry/node-core": "10.64.0", "@sentry/opentelemetry": "10.64.0", "@sentry/server-utils": "10.64.0", "import-in-the-middle": "^3.0.0" } }, "sha512-rhNZ3CTqwdTQHo9Zd+NsoLyW69VIzbMcGMRX9y8W1A6runT4YH/MDhmT0U9oWfNZKN8ngqR/gfVMTnlYVQliCA=="],
+
+    "@sentry/node-core": ["@sentry/node-core@10.64.0", "", { "dependencies": { "@sentry/conventions": "^0.15.1", "@sentry/core": "10.64.0", "@sentry/opentelemetry": "10.64.0", "import-in-the-middle": "^3.0.0" }, "peerDependencies": { "@opentelemetry/api": "^1.9.0", "@opentelemetry/core": "^1.30.1 || ^2.1.0", "@opentelemetry/exporter-trace-otlp-http": ">=0.57.0 <1", "@opentelemetry/instrumentation": ">=0.57.1 <1", "@opentelemetry/sdk-trace-base": "^1.30.1 || ^2.1.0" }, "optionalPeers": ["@opentelemetry/api", "@opentelemetry/core", "@opentelemetry/exporter-trace-otlp-http", "@opentelemetry/instrumentation", "@opentelemetry/sdk-trace-base"] }, "sha512-dcma5uEWl0SXywY4vzrlOwuz4NBPyPhrzqL1NjlU6Di/OVbyYAZJPCwsR8XYDz73PGc5sU3qKSRoXWX56Ip0wA=="],
+
+    "@sentry/opentelemetry": ["@sentry/opentelemetry@10.64.0", "", { "dependencies": { "@sentry/conventions": "^0.15.1", "@sentry/core": "10.64.0" }, "peerDependencies": { "@opentelemetry/api": "^1.9.0", "@opentelemetry/core": "^1.30.1 || ^2.1.0", "@opentelemetry/sdk-trace-base": "^1.30.1 || ^2.1.0" } }, "sha512-hXw8dwSSA9/9r3VGy0PO2SJp7g5/yH2+7Bak60EkOT21AT1BwFnVEsVQyZb+UHjG7UWne/jDbwdWPSUm/rtovw=="],
+
+    "@sentry/server-utils": ["@sentry/server-utils@10.64.0", "", { "dependencies": { "@apm-js-collab/code-transformer": "^0.15.0", "@apm-js-collab/code-transformer-bundler-plugins": "^0.5.0", "@apm-js-collab/tracing-hooks": "^0.10.1", "@sentry/conventions": "^0.15.1", "@sentry/core": "10.64.0", "magic-string": "~0.30.0" } }, "sha512-d568Jhn3WBfm07dsdPsLh0q+qRj71xZEDZFsA33kizD0UuSCR8axtc2YW6aKdPhtuqgm9tHjSX35Q9vK/XmujA=="],
+
     "@standard-schema/spec": ["@standard-schema/spec@1.1.0", "", {}, "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w=="],
 
     "@tsconfig/node10": ["@tsconfig/node10@1.0.12", "", {}, "sha512-UCYBaeFvM11aU2y3YPZ//O5Rhj+xKyzy7mvcIoAjASbigy8mHMryP5cK7dgjlz2hWxh1g5pLw084E0a/wlUSFQ=="],
@@ -176,6 +211,8 @@
 
     "assertion-error": ["assertion-error@2.0.1", "", {}, "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA=="],
 
+    "astring": ["astring@1.9.0", "", { "bin": { "astring": "bin/astring" } }, "sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg=="],
+
     "body-parser": ["body-parser@2.2.2", "", { "dependencies": { "bytes": "^3.1.2", "content-type": "^1.0.5", "debug": "^4.4.3", "http-errors": "^2.0.0", "iconv-lite": "^0.7.0", "on-finished": "^2.4.1", "qs": "^6.14.1", "raw-body": "^3.0.1", "type-is": "^2.0.1" } }, "sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA=="],
 
     "bytes": ["bytes@3.1.2", "", {}, "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg=="],
@@ -186,6 +223,8 @@
 
     "chai": ["chai@6.2.2", "", {}, "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg=="],
 
+    "cjs-module-lexer": ["cjs-module-lexer@2.2.0", "", {}, "sha512-4bHTS2YuzUvtoLjdy+98ykbNB5jS0+07EvFNXerqZQJ89F7DI6ET7OQo/HJuW6K0aVsKA9hj9/RVb2kQVOrPDQ=="],
+
     "content-disposition": ["content-disposition@1.0.1", "", {}, "sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q=="],
 
     "content-type": ["content-type@1.0.5", "", {}, "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA=="],
@@ -224,6 +263,10 @@
 
     "escape-html": ["escape-html@1.0.3", "", {}, "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow=="],
 
+    "esquery": ["esquery@1.7.0", "", { "dependencies": { "estraverse": "^5.1.0" } }, "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g=="],
+
+    "estraverse": ["estraverse@5.3.0", "", {}, "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA=="],
+
     "estree-walker": ["estree-walker@3.0.3", "", { "dependencies": { "@types/estree": "^1.0.0" } }, "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g=="],
 
     "etag": ["etag@1.8.1", "", {}, "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg=="],
@@ -270,6 +313,8 @@
 
     "iconv-lite": ["iconv-lite@0.7.2", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw=="],
 
+    "import-in-the-middle": ["import-in-the-middle@3.3.1", "", { "dependencies": { "cjs-module-lexer": "^2.2.0", "es-module-lexer": "^2.2.0", "module-details-from-path": "^1.0.4" } }, "sha512-0rymlHSFLwZ0ixx8DaQkoIyZojJPY2a0K2nEYslhKJ6jIYO/m0IcCb7iQsFPmS7WmKwISZiIrv5Icstrw/CmqA=="],
+
     "inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],
 
     "ip-address": ["ip-address@10.1.0", "", {}, "sha512-XXADHxXmvT9+CRxhXg56LJovE+bmWnEWB78LB83VZTprKTmaC5QfruXocxzTZ2Kl0DNwKuBdlIhjL8LeY8Sf8Q=="],
@@ -296,10 +341,14 @@
 
     "merge-descriptors": ["merge-descriptors@2.0.0", "", {}, "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g=="],
 
+    "meriyah": ["meriyah@6.1.4", "", {}, "sha512-Sz8FzjzI0kN13GK/6MVEsVzMZEPvOhnmmI1lU5+/1cGOiK3QUahntrNNtdVeihrO7t9JpoH75iMNXg6R6uWflQ=="],
+
     "mime-db": ["mime-db@1.54.0", "", {}, "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ=="],
 
     "mime-types": ["mime-types@3.0.2", "", { "dependencies": { "mime-db": "^1.54.0" } }, "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A=="],
 
+    "module-details-from-path": ["module-details-from-path@1.0.4", "", {}, "sha512-EGWKgxALGMgzvxYF1UyGTy0HXX/2vHLkw6+NvDKW2jypWbHpjQuj4UMcqQWXHERJhVGKikolT06G3bcKe4fi7w=="],
+
     "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
 
     "nanoid": ["nanoid@3.3.11", "", { "bin": "bin/nanoid.cjs" }, "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w=="],
@@ -342,12 +391,16 @@
 
     "require-from-string": ["require-from-string@2.0.2", "", {}, "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="],
 
+    "require-in-the-middle": ["require-in-the-middle@8.0.1", "", { "dependencies": { "debug": "^4.3.5", "module-details-from-path": "^1.0.3" } }, "sha512-QT7FVMXfWOYFbeRBF6nu+I6tr2Tf3u0q8RIEjNob/heKY/nh7drD/k7eeMFmSQgnTtCzLDcCu/XEnpW2wk4xCQ=="],
+
     "rollup": ["rollup@4.56.0", "", { "dependencies": { "@types/estree": "1.0.8" }, "optionalDependencies": { "@rollup/rollup-android-arm-eabi": "4.56.0", "@rollup/rollup-android-arm64": "4.56.0", "@rollup/rollup-darwin-arm64": "4.56.0", "@rollup/rollup-darwin-x64": "4.56.0", "@rollup/rollup-freebsd-arm64": "4.56.0", "@rollup/rollup-freebsd-x64": "4.56.0", "@rollup/rollup-linux-arm-gnueabihf": "4.56.0", "@rollup/rollup-linux-arm-musleabihf": "4.56.0", "@rollup/rollup-linux-arm64-gnu": "4.56.0", "@rollup/rollup-linux-arm64-musl": "4.56.0", "@rollup/rollup-linux-loong64-gnu": "4.56.0", "@rollup/rollup-linux-loong64-musl": "4.56.0", "@rollup/rollup-linux-ppc64-gnu": "4.56.0", "@rollup/rollup-linux-ppc64-musl": "4.56.0", "@rollup/rollup-linux-riscv64-gnu": "4.56.0", "@rollup/rollup-linux-riscv64-musl": "4.56.0", "@rollup/rollup-linux-s390x-gnu": "4.56.0", "@rollup/rollup-linux-x64-gnu": "4.56.0", "@rollup/rollup-linux-x64-musl": "4.56.0", "@rollup/rollup-openbsd-x64": "4.56.0", "@rollup/rollup-openharmony-arm64": "4.56.0", "@rollup/rollup-win32-arm64-msvc": "4.56.0", "@rollup/rollup-win32-ia32-msvc": "4.56.0", "@rollup/rollup-win32-x64-gnu": "4.56.0", "@rollup/rollup-win32-x64-msvc": "4.56.0", "fsevents": "~2.3.2" }, "bin": "dist/bin/rollup" }, "sha512-9FwVqlgUHzbXtDg9RCMgodF3Ua4Na6Gau+Sdt9vyCN4RhHfVKX2DCHy3BjMLTDd47ITDhYAnTwGulWTblJSDLg=="],
 
     "router": ["router@2.2.0", "", { "dependencies": { "debug": "^4.4.0", "depd": "^2.0.0", "is-promise": "^4.0.0", "parseurl": "^1.3.3", "path-to-regexp": "^8.0.0" } }, "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ=="],
 
     "safer-buffer": ["safer-buffer@2.1.2", "", {}, "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="],
 
+    "semifies": ["semifies@1.0.0", "", {}, "sha512-xXR3KGeoxTNWPD4aBvL5NUpMTT7WMANr3EWnaS190QVkY52lqqcVRD7Q05UVbBhiWDGWMlJEUam9m7uFFGVScw=="],
+
     "send": ["send@1.2.1", "", { "dependencies": { "debug": "^4.4.3", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "etag": "^1.8.1", "fresh": "^2.0.0", "http-errors": "^2.0.1", "mime-types": "^3.0.2", "ms": "^2.1.3", "on-finished": "^2.4.1", "range-parser": "^1.2.1", "statuses": "^2.0.2" } }, "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ=="],
 
     "serve-static": ["serve-static@2.2.1", "", { "dependencies": { "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "parseurl": "^1.3.3", "send": "^1.2.0" } }, "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw=="],
@@ -368,6 +421,8 @@
 
     "siginfo": ["siginfo@2.0.0", "", {}, "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g=="],
 
+    "source-map": ["source-map@0.6.1", "", {}, "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g=="],
+
     "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
 
     "stackback": ["stackback@0.0.2", "", {}, "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw=="],
@@ -415,5 +470,9 @@
     "zod": ["zod@4.3.5", "", {}, "sha512-k7Nwx6vuWx1IJ9Bjuf4Zt1PEllcwe7cls3VNzm4CQ1/hgtFUK2bRNG3rvnpPUhFjmqJKAKtjV576KnUkHocg/g=="],
 
     "zod-to-json-schema": ["zod-to-json-schema@3.25.1", "", { "peerDependencies": { "zod": "^3.25 || ^4" } }, "sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA=="],
+
+    "@apm-js-collab/code-transformer-bundler-plugins/es-module-lexer": ["es-module-lexer@2.3.0", "", {}, "sha512-KLdwQm2NvGLDkQDCGvmiQrhkd0JbMzXthwQAUgWjQuQdBLFa3eiBP5arXZyA+f8x+x7OXgud6bq2rxjGtHV2tw=="],
+
+    "import-in-the-middle/es-module-lexer": ["es-module-lexer@2.3.0", "", {}, "sha512-KLdwQm2NvGLDkQDCGvmiQrhkd0JbMzXthwQAUgWjQuQdBLFa3eiBP5arXZyA+f8x+x7OXgud6bq2rxjGtHV2tw=="],
   }
 }

package/dist/cli.js

@@ -24,8 +24,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * or `dist/http-server.js`); this dispatcher just gives users the
  * working one-liner they expected.
  */
+const telemetry_js_1 = require("./telemetry.js");
 async function main() {
     const argv = process.argv.slice(2);
+    (0, telemetry_js_1.initMcpTelemetry)({ transport: argv.includes("--http") ? "http" : "stdio" });
     if (argv.includes("--http")) {
         const { runFromArgv } = await import("./http-server.js");
         // Pass through every flag — http-server's parser ignores unknowns
@@ -37,7 +39,9 @@ async function main() {
     // connects the stdio transport.
     await import("./index.js");
 }
-main().catch((error) => {
+main().catch(async (error) => {
+    (0, telemetry_js_1.captureMcpException)(error, { phase: "cli_startup" });
+    await (0, telemetry_js_1.flushMcpTelemetry)();
     console.error("Fatal error:", error);
     process.exit(1);
 });

package/dist/http-server.js

@@ -28,6 +28,7 @@ const http_1 = require("http");
 const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
 const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const telemetry_1 = require("./telemetry");
 class CliError extends Error {
 }
 exports.CliError = CliError;
@@ -311,6 +312,7 @@ function buildHttpServer(config) {
  * below.
  */
 function runFromArgv(argv) {
+    (0, telemetry_1.initMcpTelemetry)({ transport: "http" });
     let config;
     try {
         config = parseArgs(argv);
@@ -323,6 +325,10 @@ function runFromArgv(argv) {
         throw e;
     }
     const server = buildHttpServer(config);
+    server.on("error", async (error) => {
+        (0, telemetry_1.captureMcpException)(error, { phase: "http_server" });
+        await (0, telemetry_1.flushMcpTelemetry)();
+    });
     server.listen(config.mcpPort, config.host, () => {
         const printable = config.host === "0.0.0.0" ? "0.0.0.0 (LAN)" : config.host;
         console.log(`Screenpipe MCP HTTP server listening on ${printable}:${config.mcpPort}`);

package/dist/index.js

@@ -44,6 +44,8 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const notification_request_1 = require("./notification-request");
+const telemetry_1 = require("./telemetry");
+(0, telemetry_1.initMcpTelemetry)({ transport: "stdio" });
 // Parse command line arguments
 const args = process.argv.slice(2);
 let port = 3030;
@@ -229,6 +231,7 @@ function discoverApiKey() {
         "or install the screenpipe desktop app (https://screenpi.pe).",
         "",
     ].join("\n"));
+    (0, telemetry_1.captureMcpMessage)("api key discovery failed", "warning", { phase: "api_key_discovery" });
     return "";
 }
 const API_KEY = discoverApiKey();
@@ -352,16 +355,19 @@ const TOOLS = [
     },
     {
         name: "list-meetings",
-        description: "List detected meetings (Zoom, Teams, Meet, etc.) with duration, app, and attendees. " +
-            "Only available when screenpipe runs in smart transcription mode. " +
-            "Pass `q` to filter by substring match against title, attendees, and notes (e.g. an email or name).",
+        description: "List detected meetings (Zoom, Teams, Meet, etc.) with id, duration, app, attendees, and note status. " +
+            "Pass `q` to substring-match title, attendee names/emails, and notes — `q` searches ALL meeting history, so when " +
+            "looking for a meeting with a person or on a topic ('when did I last talk to Noah?'), pass `q` and OMIT start_time. " +
+            "Only constrain the time range when the question itself is time-bound. Results are newest-first; without `q`, old " +
+            "meetings only surface via time range or offset pagination. Follow up with get-meeting (id from results) for the " +
+            "full note and transcript.",
         annotations: { title: "List Meetings", readOnlyHint: true, openWorldHint: false, idempotentHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                start_time: { type: "string", description: "ISO 8601 UTC or relative (e.g. '1d ago')" },
+                start_time: { type: "string", description: "ISO 8601 UTC or relative (e.g. '1d ago'). Omit when searching by q — it filters all history." },
                 end_time: { type: "string", description: "ISO 8601 UTC or relative" },
-                q: { type: "string", description: "Case-insensitive substring filter on title, attendees, and note" },
+                q: { type: "string", description: "Case-insensitive substring filter on title, attendees (names/emails), and note. Searches all history." },
                 limit: { type: "integer", description: "Max results (default 20)", default: 20 },
                 offset: { type: "integer", description: "Pagination offset", default: 0 },
             },
@@ -475,15 +481,17 @@ const TOOLS = [
                 timeout_secs: { type: "integer", description: "Auto-dismiss after N seconds (default 20). Use 0 for persistent.", default: 20 },
                 actions: {
                     type: "array",
-                    description: "Up to 5 action buttons. Each needs id, label, type ('pipe'|'api'|'deeplink'|'dismiss').",
+                    description: "Up to 5 action buttons. Each needs id, label, type ('pipe'|'chat'|'api'|'deeplink'|'dismiss').",
                     items: {
                         type: "object",
                         properties: {
                             id: { type: "string", description: "Unique action ID" },
                             label: { type: "string", description: "Button label" },
-                            type: { type: "string", enum: ["pipe", "api", "deeplink", "dismiss"], description: "Action type" },
-                            pipe: { type: "string", description: "Pipe name to run (type=pipe)" },
-                            context: { type: "object", description: "Context passed to pipe (type=pipe)" },
+                            type: { type: "string", enum: ["pipe", "chat", "api", "deeplink", "dismiss"], description: "Action type. 'pipe' runs an installed pipe; 'chat' runs an inline prompt in a fresh chat session (no installed pipe needed)." },
+                            pipe: { type: "string", description: "Target pipe to run when clicked (type=pipe). Set this explicitly — e.g. a 'share-data' pipe. If omitted it falls back to the sending pipe, which usually does nothing useful." },
+                            prompt: { type: "string", description: "Instruction to run in a fresh chat session when clicked (type=chat). Write the whole task inline — no pre-installed pipe required." },
+                            auto_send: { type: "boolean", description: "type=chat: auto-send the prompt (default true). Set false to pre-fill chat for the user to review before sending." },
+                            context: { type: "object", description: "Data passed to the action (type=pipe → injected into the pipe prompt; type=chat → included as background context)" },
                             open_in_chat: { type: "boolean", description: "Open pipe run in chat UI instead of background (type=pipe)" },
                             url: { type: "string", description: "URL for api/deeplink actions" },
                         },
@@ -601,12 +609,24 @@ const TOOLS = [
     },
     {
         name: "get-meeting",
-        description: "Get details of a specific meeting by ID, including transcription and attendees.",
+        description: "Get a meeting by ID: title, attendees, times, and the full note. " +
+            "Pass include_transcript=true to also get the speaker-attributed transcript segments — do this when the note is " +
+            "empty and you need to reconstruct what was said (much better than searching raw audio by time range).",
         annotations: { title: "Get Meeting", readOnlyHint: true, openWorldHint: false, idempotentHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                id: { type: "integer", description: "Meeting ID" },
+                id: { type: "integer", description: "Meeting ID (from list-meetings results)" },
+                include_transcript: {
+                    type: "boolean",
+                    description: "Also return the meeting's transcript segments with speaker names and timestamps.",
+                    default: false,
+                },
+                transcript_offset: {
+                    type: "integer",
+                    description: "Skip this many transcript segments (pagination for long meetings).",
+                    default: 0,
+                },
             },
             required: ["id"],
         },
@@ -931,7 +951,8 @@ server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) =
 ## Common Patterns
 
 - "What was I doing for the last 2 hours?" → activity-summary with start_time='2h ago'
-- "What did I discuss in my meeting?" → list-meetings to find it, then search-content with audio + that time range
+- "What did I discuss in my meeting?" → list-meetings to find it, then get-meeting with include_transcript=true
+- "When did I last talk to <person>?" → list-meetings with q=<name or email>, NO start_time (q searches all history)
 - "Find when I was on Twitter" → search-content with app_name='Arc' (or the browser name), q='twitter'
 - "Remember that I prefer X" → update-memory with content describing the preference
 - "What do you remember about X?" → search-content with content_type='memory', q='X'
@@ -1405,8 +1426,14 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 const response = await callAPI(`/meetings?${params.toString()}`);
                 const meetings = await response.json();
                 if (!Array.isArray(meetings) || meetings.length === 0) {
+                    const hadTimeFilter = normalized.start_time || normalized.end_time;
+                    const hint = normalized.q
+                        ? hadTimeFilter
+                            ? " Retry the same q WITHOUT start_time/end_time — q searches all meeting history."
+                            : " Try a shorter substring (single first name, email fragment) — matching is exact-substring, not fuzzy."
+                        : " Pass q (name/email/topic, searches all history) or widen the time range.";
                     return {
-                        content: [{ type: "text", text: "No meetings found in the given time range." }],
+                        content: [{ type: "text", text: `No meetings matched.${hint}` }],
                     };
                 }
                 const formatted = meetings.map((m) => {
@@ -1415,7 +1442,11 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     const app = m.meeting_app;
                     const title = m.title ? ` — ${m.title}` : "";
                     const attendees = m.attendees ? `\nAttendees: ${m.attendees}` : "";
-                    return `[${m.detection_source}] ${app}${title}\n  ${start} → ${end}${attendees}`;
+                    const noteStr = typeof m.note === "string" ? m.note.trim() : "";
+                    const note = noteStr
+                        ? `\nNote: ${noteStr.length > 200 ? `${noteStr.slice(0, 200)}…` : noteStr}`
+                        : "\nNote: (none — use get-meeting with include_transcript to reconstruct)";
+                    return `[id ${m.id}] [${m.detection_source}] ${app}${title}\n  ${start} → ${end}${attendees}${note}`;
                 });
                 return {
                     content: [
@@ -1794,8 +1825,45 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 }
                 const response = await callAPI(`/meetings/${meetingId}`);
                 const meeting = await response.json();
+                let text = JSON.stringify(meeting, null, 2);
+                if (args.include_transcript) {
+                    const tRes = await callAPI(`/meetings/${meetingId}/transcript`);
+                    const segments = await tRes.json();
+                    if (!Array.isArray(segments) || segments.length === 0) {
+                        text += "\n\nTranscript: (no segments recorded for this meeting)";
+                    }
+                    else {
+                        // Cap the payload: long meetings can have hundreds of segments.
+                        const offset = Math.max(0, args.transcript_offset || 0);
+                        const MAX_SEGMENTS = 200;
+                        const MAX_CHARS = 40_000;
+                        const page = segments.slice(offset, offset + MAX_SEGMENTS);
+                        const lines = [];
+                        let chars = 0;
+                        let shown = 0;
+                        for (const s of page) {
+                            // MeetingTranscriptSegment serializes camelCase (unlike MeetingRecord)
+                            const capturedAt = (s.capturedAt ?? s.captured_at);
+                            const when = typeof capturedAt === "string" ? capturedAt.slice(11, 19) : "";
+                            const speaker = (s.speakerName ?? s.speaker_name) ||
+                                (s.deviceType ?? s.device_type) ||
+                                "unknown";
+                            const line = `[${when}] ${speaker}: ${s.transcript}`;
+                            if (chars + line.length > MAX_CHARS)
+                                break;
+                            lines.push(line);
+                            chars += line.length;
+                            shown++;
+                        }
+                        const remaining = segments.length - offset - shown;
+                        const more = remaining > 0
+                            ? `\n… ${remaining} more segments — call again with transcript_offset=${offset + shown}.`
+                            : "";
+                        text += `\n\nTranscript (${segments.length} segments, showing ${offset + 1}-${offset + shown}):\n${lines.join("\n")}${more}`;
+                    }
+                }
                 return {
-                    content: [{ type: "text", text: JSON.stringify(meeting, null, 2) }],
+                    content: [{ type: "text", text }],
                 };
             }
             case "update-meeting": {
@@ -1978,6 +2046,9 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        if (!(error instanceof BackendDownError) && !(error instanceof BackendHttpError)) {
+            (0, telemetry_1.captureMcpMessage)("tool call failed", "error", { phase: "tool_call", tool: name });
+        }
         // isError flags the result as a failure so the model retries with a
         // different approach instead of treating the error text as data.
         return {
@@ -1992,7 +2063,9 @@ async function main() {
     await server.connect(transport);
     console.error("Screenpipe MCP server running on stdio");
 }
-main().catch((error) => {
+main().catch(async (error) => {
+    (0, telemetry_1.captureMcpException)(error, { phase: "stdio_startup" });
+    await (0, telemetry_1.flushMcpTelemetry)();
     console.error("Fatal error:", error);
     process.exit(1);
 });

package/dist/telemetry.d.ts

@@ -0,0 +1,21 @@
+import * as Sentry from "@sentry/node";
+type TelemetryContext = {
+    transport?: "stdio" | "http";
+    phase?: string;
+    tool?: string;
+};
+type SanitizableEvent = {
+    request?: unknown;
+    user?: unknown;
+    extra?: unknown;
+    breadcrumbs?: unknown[];
+    contexts?: Record<string, unknown>;
+};
+export declare function isMcpTelemetryDisabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function scrubSensitiveValue(value: string): string;
+export declare function sanitizeSentryEvent<T extends SanitizableEvent>(event: T): T | null;
+export declare function initMcpTelemetry(context?: TelemetryContext): boolean;
+export declare function captureMcpException(error: unknown, context?: TelemetryContext): void;
+export declare function captureMcpMessage(message: string, level?: Sentry.SeverityLevel, context?: TelemetryContext): void;
+export declare function flushMcpTelemetry(timeoutMs?: number): Promise<void>;
+export {};