@nylas/helix-mcp-server 0.1.0

package/dist/tools/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/tools/email.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,UAAU,EAAE,cAAc,EAuDtC,CAAA"}

package/dist/tools/email.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export const emailTools = [
+    {
+        name: 'email_search',
+        description: "Search the user's email by query, sender, recipient, or date range. Returns matching messages with subject, sender, date, and snippet.",
+        inputSchema: z.object({
+            query: z.string().optional().describe('Free-text search query'),
+            from: z.string().optional().describe('Filter by sender email address'),
+            to: z.string().optional().describe('Filter by recipient email address'),
+            subject: z.string().optional().describe('Filter by subject line'),
+            after: z.string().optional().describe('Return emails after this ISO-8601 date'),
+            before: z.string().optional().describe('Return emails before this ISO-8601 date'),
+            unread: z.boolean().optional().describe('Filter by unread status'),
+            limit: z.number().min(1).max(50).default(10).describe('Maximum results to return'),
+        }),
+        requiredScopes: ['email.read'],
+        category: 'email',
+    },
+    {
+        name: 'email_read',
+        description: 'Read the full body and metadata of a specific email message by its ID.',
+        inputSchema: z.object({
+            message_id: z.string().describe('The ID of the email message to read'),
+        }),
+        requiredScopes: ['email.read'],
+        category: 'email',
+    },
+    {
+        name: 'email_send',
+        description: 'Compose and send an email. Subject to the user\'s approval policy — may return a pending_approval status instead of sending immediately.',
+        inputSchema: z.object({
+            to: z.array(z.object({
+                email: z.string().email(),
+                name: z.string().optional(),
+            })).min(1).describe('Recipients'),
+            subject: z.string().describe('Email subject line'),
+            body: z.string().describe('Email body (plain text or HTML)'),
+            reply_to_message_id: z.string().optional().describe('Message ID to reply to (for threading)'),
+        }),
+        requiredScopes: ['email.send'],
+        category: 'email',
+    },
+    {
+        name: 'email_reply',
+        description: "Reply to an existing email thread. The AI identity will match the user's communication style.",
+        inputSchema: z.object({
+            thread_id: z.string().describe('Thread ID to reply to'),
+            body: z.string().describe('Reply body'),
+        }),
+        requiredScopes: ['email.send'],
+        category: 'email',
+    },
+];
+//# sourceMappingURL=email.js.map

package/dist/tools/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/tools/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,UAAU,GAAqB;IAC3C;QACC,IAAI,EAAE,cAAc;QACpB,WAAW,EACV,wIAAwI;QACzI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAC/D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACtE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACvE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YACjE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YAC/E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACjF,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SAClF,CAAC;QACF,cAAc,EAAE,CAAC,YAAY,CAAC;QAC9B,QAAQ,EAAE,OAAO;KACjB;IACD;QACC,IAAI,EAAE,YAAY;QAClB,WAAW,EACV,wEAAwE;QACzE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;SACtE,CAAC;QACF,cAAc,EAAE,CAAC,YAAY,CAAC;QAC9B,QAAQ,EAAE,OAAO;KACjB;IACD;QACC,IAAI,EAAE,YAAY;QAClB,WAAW,EACV,0IAA0I;QAC3I,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;gBACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC3B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;YACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC5D,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SAC7F,CAAC;QACF,cAAc,EAAE,CAAC,YAAY,CAAC;QAC9B,QAAQ,EAAE,OAAO;KACjB;IACD;QACC,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,+FAA+F;QAChG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACvD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;SACvC,CAAC;QACF,cAAc,EAAE,CAAC,YAAY,CAAC;QAC9B,QAAQ,EAAE,OAAO;KACjB;CACD,CAAA"}

package/dist/tools/identity.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './types.js';
+export declare const identityTools: ToolDefinition[];
+//# sourceMappingURL=identity.d.ts.map

package/dist/tools/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/tools/identity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,aAAa,EAAE,cAAc,EAiBzC,CAAA"}

package/dist/tools/identity.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export const identityTools = [
+    {
+        name: 'identity_get_context',
+        description: "Get the user's AI identity context: preferences, communication style, timezone, and recent activity summary. Use this to understand how the user prefers to communicate before drafting emails or scheduling.",
+        inputSchema: z.object({}),
+        requiredScopes: ['identity.read'],
+        category: 'identity',
+    },
+    {
+        name: 'meta_whoami',
+        description: 'Get information about the authenticated integration: user email, granted scopes, and rate limit status.',
+        inputSchema: z.object({}),
+        requiredScopes: ['identity.read'],
+        category: 'identity',
+    },
+];
+//# sourceMappingURL=identity.js.map

package/dist/tools/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/tools/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC9C;QACC,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACV,+MAA+M;QAChN,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,cAAc,EAAE,CAAC,eAAe,CAAC;QACjC,QAAQ,EAAE,UAAU;KACpB;IACD;QACC,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,yGAAyG;QAC1G,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,cAAc,EAAE,CAAC,eAAe,CAAC;QACjC,QAAQ,EAAE,UAAU;KACpB;CACD,CAAA"}

package/dist/tools/types.d.ts

@@ -0,0 +1,10 @@
+import type { z } from 'zod';
+export type ToolCategory = 'email' | 'calendar' | 'contacts' | 'identity';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType;
+    requiredScopes: string[];
+    category: ToolCategory;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAA;AAEzE,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAA;IACtB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,EAAE,YAAY,CAAA;CACtB"}

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@nylas/helix-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server and CLI for Nylas Helix — email, calendar, contacts, and identity context for AI agents.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "helix-mcp-server": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepack": "pnpm run build",
+    "lint": "biome check src/",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "mcp",
+    "nylas",
+    "helix",
+    "ai",
+    "email",
+    "calendar",
+    "identity"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nylas/helix"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.8.0"
+  }
+}