mcp-sunsama 0.15.4 → 0.16.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # mcp-sunsama
 
+## 0.16.1
+
+### Patch Changes
+
+- 5df00f4: Bump sunsama-api dependency from 0.12.0 to 0.12.1
+- 14c0713: Fix update-task-notes tool failing with MCP error -32603. Removed Zod `.refine()` from schema which was causing MCP SDK to fail parsing the tool parameters. XOR validation between html/markdown is now handled at runtime.
+
+## 0.16.0
+
+### Minor Changes
+
+- 56872df: Add GitHub and Gmail integration support to create-task tool
+
+  This minor release adds support for creating Sunsama tasks with GitHub and Gmail integrations, enabling users to convert GitHub issues/PRs and Gmail emails into tasks with proper linking and metadata.
+
+  **New Features:**
+
+  - Added `TaskGithubIntegration` schema with all required fields (id, repositoryOwnerLogin, repositoryName, number, type, url)
+  - Added `TaskGmailIntegration` schema with all required fields (id, messageId, accountId, url)
+  - Updated `create-task` tool to accept optional `integration` parameter
+  - Implemented discriminated union pattern for type-safe integration handling
+  - Full TypeScript support with Zod schema validation
+
+  **Migration:**
+  No breaking changes. This is a purely additive feature that extends existing functionality. The integration parameter is optional, so existing code will continue to work without modifications.
+
 ## 0.15.4
 
 ### Patch Changes

package/CLAUDE.md

@@ -28,6 +28,31 @@ bun run version            # Apply changesets and update version
 bun run release            # Build and publish to npm
 ```
 
+## Contribution Workflow
+
+**IMPORTANT**: When making changes that affect package users, always create a changeset.
+
+### When to Create a Changeset
+- ✅ New user-facing features or tools
+- ✅ Bug fixes that affect npm package users
+- ✅ API changes or breaking changes
+- ✅ Dependency updates that change behavior
+
+### When NOT to Create a Changeset
+- ❌ Infrastructure/deployment changes (CI/CD, Docker, Smithery config)
+- ❌ Internal refactoring with no behavior changes
+- ❌ Documentation updates
+- ❌ Development tooling changes
+
+### Standard Workflow
+1. Create a branch: `git checkout -b {type}/{short-name}`
+2. Make changes and test: `bun test && bun run typecheck`
+3. **Create a changeset**: `bun run changeset` (if changes affect users)
+4. Commit with conventional format: `git commit -m "fix: description"`
+5. Push and create PR
+
+See `CONTRIBUTING.md` for full details.
+
 ## Architecture Overview
 
 ### Dual Transport MCP Server
@@ -87,8 +112,16 @@ All tools use Zod schemas from `schemas.ts`:
 - Automatic TypeScript inference
 - Comprehensive parameter documentation
 - Union types for completion filters
-- XOR schema patterns for mutually exclusive parameters using `.refine()` for MCP Inspector compatibility
-- Example: `update-task-notes` requires either `html` OR `markdown`, but not both
+- **Important**: Avoid using `.refine()` on schemas - it transforms `ZodObject` into `ZodEffects` which the MCP SDK cannot parse (results in empty `properties`). Handle complex validation (e.g., XOR between fields) in the tool's `execute` function instead.
+- Example: `update-task-notes` requires either `html` OR `markdown`, validated at runtime
+- Discriminated unions for task integrations (GitHub, Gmail)
+
+### Integration Support
+The `create-task` tool supports external integrations:
+- **GitHub Integration**: Link tasks to GitHub issues or pull requests
+- **Gmail Integration**: Link tasks to Gmail emails
+- Uses discriminated union pattern for type-safe integration handling
+- Integration parameter is optional to maintain backward compatibility
 
 ## Key Patterns
 
@@ -149,7 +182,7 @@ src/
 ├── tools/
 │   ├── shared.ts          # Common utilities and tool wrapper patterns
 │   ├── user-tools.ts      # User operations (get-user)
-│   ├── task-tools.ts      # Task operations (14 tools)
+│   ├── task-tools.ts      # Task operations (15 tools)
 │   ├── stream-tools.ts    # Stream operations (get-streams)
 │   └── index.ts           # Export all tools
 ├── resources/
@@ -193,7 +226,7 @@ __tests__/
 
 **Resource-Based Organization**:
 - **User Tools**: Single tool for user operations
-- **Task Tools**: 14 tools organized by function (query, lifecycle, update)
+- **Task Tools**: 15 tools organized by function (query, lifecycle, update)
 - **Stream Tools**: Single tool for stream operations
 
 **Type Safety Improvements**:
@@ -227,7 +260,7 @@ Tests are organized in the `__tests__/` directory following standard conventions
 ## Important Notes
 
 ### Version Synchronization
-Always keep FastMCP server version in `src/main.ts` (line 19) synchronized with `package.json` version.
+The MCP server version in `src/constants.ts` is automatically synced from `package.json` when running `bun run version`.
 
 ### Environment Variables
 Required for stdio transport:
@@ -244,7 +277,7 @@ Optional:
 ### Task Operations
 Full CRUD support:
 - **Read**: `get-tasks-by-day`, `get-tasks-backlog`, `get-archived-tasks`, `get-task-by-id`, `get-streams`
-- **Write**: `create-task`, `update-task-complete`, `update-task-planned-time`, `update-task-notes`, `update-task-snooze-date`, `update-task-backlog`, `update-task-stream`, `delete-task`
+- **Write**: `create-task` (with GitHub/Gmail integration support), `update-task-complete`, `update-task-planned-time`, `update-task-notes`, `update-task-snooze-date`, `update-task-backlog`, `update-task-stream`, `update-task-text`, `update-task-due-date`, `delete-task`
 
 Task read operations support response trimming. `get-tasks-by-day` includes completion filtering. `get-archived-tasks` includes enhanced pagination with hasMore flag for LLM decision-making.
 
@@ -254,12 +287,11 @@ Configure different server variants in `mcp-inspector.json` for testing various
 
 ## Version Management
 
-**IMPORTANT**: Keep the FastMCP server version in sync with package.json version.
+Version is managed automatically via changesets. When you run `bun run version`:
+1. Changesets updates `package.json` version
+2. `scripts/sync-version.ts` automatically syncs the version to `src/constants.ts`
 
-When updating the version:
-1. Update `package.json` version (done automatically by changesets)
-2. Manually update the FastMCP server version in `src/main.ts` (line 19)
-3. Both versions must be identical for consistency
+No manual version updates needed.
 
 ## Git Rules
 

package/CONTRIBUTING.md

@@ -55,12 +55,24 @@ Example: `feat/add-task-labels`
    bun run build
    ```
 
-5. Create a changeset for your changes:
+5. Create a changeset for your changes (if needed):
    ```bash
    bun run changeset
    ```
    Follow the prompts to describe your changes.
 
+   **When to create a changeset:**
+   - ✅ New user-facing features or tools
+   - ✅ Bug fixes that affect npm package users
+   - ✅ API changes or breaking changes
+   - ✅ Dependency updates that change behavior
+
+   **When NOT to create a changeset:**
+   - ❌ Infrastructure/deployment changes (CI/CD, Docker, Smithery config)
+   - ❌ Internal refactoring with no behavior changes
+   - ❌ Documentation updates
+   - ❌ Development tooling changes
+
 6. Commit your changes using conventional commit format:
    ```bash
    git add .
@@ -155,11 +167,9 @@ This project uses [changesets](https://github.com/changesets/changesets) for ver
    bun run version       # Apply changesets and update package.json
    ```
 
-   **IMPORTANT**: After running this command, manually update the MCP server version in `src/main.ts` (line ~19) to match the new version in `package.json`:
+   **IMPORTANT**: After this command, manually update the version in `src/constants.ts` to match `package.json`:
    ```typescript
-   const server = new FastMCP({
-     name: "Sunsama API Server",
-     version: "X.Y.Z",  // <-- Update this to match package.json
+   export const VERSION = "X.Y.Z";  // <-- Update to match package.json
    ```
 
 3. **Pre-Release Validation**
@@ -177,7 +187,6 @@ This project uses [changesets](https://github.com/changesets/changesets) for ver
    Verify the commit includes:
    - `package.json` - version bump
    - `CHANGELOG.md` - generated changelog
-   - `src/main.ts` - MCP server version update
    - Removed changeset files from `.changeset/`
 
 5. **Publish to NPM**
@@ -199,7 +208,11 @@ This project uses [changesets](https://github.com/changesets/changesets) for ver
 
 #### Version Synchronization
 
-The MCP server version in `src/main.ts` must always match the version in `package.json`. This ensures clients receive accurate version information during the MCP handshake.
+**IMPORTANT**: When updating the version, you must update it in TWO places:
+1. `package.json` - The npm package version
+2. `src/constants.ts` - The `VERSION` constant
+
+This ensures the MCP server reports the correct version to clients during the handshake.
 
 #### Troubleshooting Releases
 

package/README.md

@@ -2,10 +2,14 @@
 
 A Model Context Protocol (MCP) server that provides comprehensive task management capabilities through the Sunsama API. This server enables AI assistants to access Sunsama tasks, create new tasks, mark tasks complete, and manage your productivity workflow.
 
+<a href="https://glama.ai/mcp/servers/@robertn702/mcp-sunsama">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@robertn702/mcp-sunsama/badge" />
+</a>
+
 ## Features
 
 ### Task Management
-- **Create Tasks** - Create new tasks with notes, time estimates, due dates, and stream assignments
+- **Create Tasks** - Create new tasks with notes, time estimates, due dates, stream assignments, and GitHub/Gmail integrations
 - **Read Tasks** - Get tasks by day with completion filtering, access backlog tasks, retrieve archived task history
 - **Update Tasks** - Mark tasks as complete with custom timestamps, reschedule tasks or move to backlog
 - **Delete Tasks** - Permanently remove tasks from your workspace
@@ -110,7 +114,7 @@ Add this configuration to your Claude Desktop MCP settings:
 ## API Tools
 
 ### Task Management
-- `create-task` - Create new tasks with optional properties
+- `create-task` - Create new tasks with optional properties including GitHub issue/PR and Gmail integration
 - `get-tasks-by-day` - Get tasks for a specific day with completion filtering
 - `get-tasks-backlog` - Get backlog tasks
 - `get-archived-tasks` - Get archived tasks with pagination (includes hasMore flag for LLM context)
@@ -129,6 +133,74 @@ Add this configuration to your Claude Desktop MCP settings:
 - `get-user` - Get current user information
 - `get-streams` - Get streams/channels for project organization
 
+### Integration Examples
+
+The `create-task` tool supports linking tasks to external services like GitHub and Gmail.
+
+#### GitHub Integration
+
+Link a task to a GitHub issue:
+```json
+{
+  "text": "Fix authentication bug",
+  "integration": {
+    "service": "github",
+    "identifier": {
+      "id": "I_kwDOO4SCuM7VTB4n",
+      "repositoryOwnerLogin": "robertn702",
+      "repositoryName": "mcp-sunsama",
+      "number": 42,
+      "type": "Issue",
+      "url": "https://github.com/robertn702/mcp-sunsama/issues/42",
+      "__typename": "TaskGithubIntegrationIdentifier"
+    },
+    "__typename": "TaskGithubIntegration"
+  }
+}
+```
+
+Link a task to a GitHub pull request:
+```json
+{
+  "text": "Review API refactoring PR",
+  "integration": {
+    "service": "github",
+    "identifier": {
+      "id": "PR_kwDOO4SCuM7VTB5o",
+      "repositoryOwnerLogin": "robertn702",
+      "repositoryName": "mcp-sunsama",
+      "number": 15,
+      "type": "PullRequest",
+      "url": "https://github.com/robertn702/mcp-sunsama/pull/15",
+      "__typename": "TaskGithubIntegrationIdentifier"
+    },
+    "__typename": "TaskGithubIntegration"
+  }
+}
+```
+
+#### Gmail Integration
+
+Link a task to a Gmail email:
+```json
+{
+  "text": "Respond to project update email",
+  "integration": {
+    "service": "gmail",
+    "identifier": {
+      "id": "19a830b40fd7ab7d",
+      "messageId": "19a830b40fd7ab7d",
+      "accountId": "user@example.com",
+      "url": "https://mail.google.com/mail/u/user@example.com/#inbox/19a830b40fd7ab7d",
+      "__typename": "TaskGmailIntegrationIdentifier"
+    },
+    "__typename": "TaskGmailIntegration"
+  }
+}
+```
+
+**Note**: All integration parameters are optional. Tasks can be created without integrations for standard task management.
+
 ## Development
 
 ### Running in Development
@@ -171,7 +243,7 @@ src/
 ├── tools/
 │   ├── shared.ts          # Common utilities and patterns
 │   ├── user-tools.ts      # User operations (get-user)
-│   ├── task-tools.ts      # Task operations (14 tools)
+│   ├── task-tools.ts      # Task operations (15 tools)
 │   ├── stream-tools.ts    # Stream operations (get-streams)
 │   └── index.ts           # Export all tools
 ├── resources/

package/bun.lock

@@ -1,5 +1,6 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "mcp-sunsama",
@@ -9,7 +10,7 @@
         "cors": "^2.8.5",
         "express": "^5.1.0",
         "papaparse": "^5.5.3",
-        "sunsama-api": "0.11.2",
+        "sunsama-api": "0.12.1",
         "zod": "3.24.4",
       },
       "devDependencies": {
@@ -396,7 +397,7 @@
 
     "strip-bom": ["strip-bom@3.0.0", "", {}, "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA=="],
 
-    "sunsama-api": ["sunsama-api@0.11.2", "", { "dependencies": { "graphql": "^16.11.0", "graphql-tag": "^2.12.6", "marked": "^14.1.3", "tough-cookie": "^5.1.2", "tslib": "^2.8.1", "turndown": "^7.2.0", "yjs": "^13.6.27", "zod": "^3.25.64" } }, "sha512-tyBrCai6Z0jEmRXkwGY+0PlXJTAwE3IJXXRCDcGFwpFPxFO5fyxw6mqM/RhYu7OGhP3AF7w4CikvEOBDaFXvKA=="],
+    "sunsama-api": ["sunsama-api@0.12.1", "", { "dependencies": { "graphql": "^16.11.0", "graphql-tag": "^2.12.6", "marked": "^14.1.3", "tough-cookie": "^5.1.2", "tslib": "^2.8.1", "turndown": "^7.2.0", "yjs": "^13.6.27", "zod": "^3.25.64" } }, "sha512-F2GLJjanAeboP4vYg3VIKP8xxQ/8LLqHhNFx3lm9oONOSvLzVAXEJlwonESuUI/iIf93b2i/jYCJ/2guoUhRYQ=="],
 
     "term-size": ["term-size@2.2.1", "", {}, "sha512-wK0Ri4fOGjv/XPy8SBHZChl8CM7uMc5VML7SqiQ0zG7+J5Vr+RMQDoHa2CNT6KHUnTGIXH34UDMkPzAUyapBZg=="],
 

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Application constants
+ *
+ * VERSION is automatically synced from package.json by scripts/sync-version.ts
+ * when running `bun run version`
+ */
+export declare const VERSION = "0.16.1";
+export declare const SERVER_NAME = "Sunsama API Server";
+export declare const PACKAGE_NAME = "mcp-sunsama";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,OAAO,WAAW,CAAC;AAChC,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,eAAO,MAAM,YAAY,gBAAgB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,9 @@
+/**
+ * Application constants
+ *
+ * VERSION is automatically synced from package.json by scripts/sync-version.ts
+ * when running `bun run version`
+ */
+export const VERSION = "0.16.1";
+export const SERVER_NAME = "Sunsama API Server";
+export const PACKAGE_NAME = "mcp-sunsama";

package/dist/main.js

@@ -5,11 +5,12 @@ import { setupStdioTransport } from "./transports/stdio.js";
 import { setupHttpTransport } from "./transports/http.js";
 import { allTools } from "./tools/index.js";
 import { apiDocumentationResource } from "./resources/index.js";
+import { VERSION, SERVER_NAME } from "./constants.js";
 // Async IIFE for top-level await and error handling
 (async () => {
     const server = new McpServer({
-        name: "Sunsama API Server",
-        version: "0.15.4",
+        name: SERVER_NAME,
+        version: VERSION,
         instructions: `
 This MCP server provides access to the Sunsama API for task and project management.
 

package/dist/schemas.d.ts

@@ -54,6 +54,101 @@ export declare const createTaskSchema: z.ZodObject<{
     snoozeUntil: z.ZodOptional<z.ZodString>;
     private: z.ZodOptional<z.ZodBoolean>;
     taskId: z.ZodOptional<z.ZodString>;
+    integration: z.ZodOptional<z.ZodDiscriminatedUnion<"service", [z.ZodObject<{
+        service: z.ZodLiteral<"github">;
+        identifier: z.ZodObject<{
+            id: z.ZodString;
+            repositoryOwnerLogin: z.ZodString;
+            repositoryName: z.ZodString;
+            number: z.ZodNumber;
+            type: z.ZodEnum<["Issue", "PullRequest"]>;
+            url: z.ZodString;
+            __typename: z.ZodLiteral<"TaskGithubIntegrationIdentifier">;
+        }, "strip", z.ZodTypeAny, {
+            number: number;
+            type: "Issue" | "PullRequest";
+            id: string;
+            url: string;
+            repositoryOwnerLogin: string;
+            repositoryName: string;
+            __typename: "TaskGithubIntegrationIdentifier";
+        }, {
+            number: number;
+            type: "Issue" | "PullRequest";
+            id: string;
+            url: string;
+            repositoryOwnerLogin: string;
+            repositoryName: string;
+            __typename: "TaskGithubIntegrationIdentifier";
+        }>;
+        __typename: z.ZodLiteral<"TaskGithubIntegration">;
+    }, "strip", z.ZodTypeAny, {
+        __typename: "TaskGithubIntegration";
+        service: "github";
+        identifier: {
+            number: number;
+            type: "Issue" | "PullRequest";
+            id: string;
+            url: string;
+            repositoryOwnerLogin: string;
+            repositoryName: string;
+            __typename: "TaskGithubIntegrationIdentifier";
+        };
+    }, {
+        __typename: "TaskGithubIntegration";
+        service: "github";
+        identifier: {
+            number: number;
+            type: "Issue" | "PullRequest";
+            id: string;
+            url: string;
+            repositoryOwnerLogin: string;
+            repositoryName: string;
+            __typename: "TaskGithubIntegrationIdentifier";
+        };
+    }>, z.ZodObject<{
+        service: z.ZodLiteral<"gmail">;
+        identifier: z.ZodObject<{
+            id: z.ZodString;
+            messageId: z.ZodString;
+            accountId: z.ZodString;
+            url: z.ZodString;
+            __typename: z.ZodLiteral<"TaskGmailIntegrationIdentifier">;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            url: string;
+            __typename: "TaskGmailIntegrationIdentifier";
+            messageId: string;
+            accountId: string;
+        }, {
+            id: string;
+            url: string;
+            __typename: "TaskGmailIntegrationIdentifier";
+            messageId: string;
+            accountId: string;
+        }>;
+        __typename: z.ZodLiteral<"TaskGmailIntegration">;
+    }, "strip", z.ZodTypeAny, {
+        __typename: "TaskGmailIntegration";
+        service: "gmail";
+        identifier: {
+            id: string;
+            url: string;
+            __typename: "TaskGmailIntegrationIdentifier";
+            messageId: string;
+            accountId: string;
+        };
+    }, {
+        __typename: "TaskGmailIntegration";
+        service: "gmail";
+        identifier: {
+            id: string;
+            url: string;
+            __typename: "TaskGmailIntegrationIdentifier";
+            messageId: string;
+            accountId: string;
+        };
+    }>]>>;
 }, "strip", z.ZodTypeAny, {
     text: string;
     taskId?: string | undefined;
@@ -63,6 +158,29 @@ export declare const createTaskSchema: z.ZodObject<{
     dueDate?: string | undefined;
     snoozeUntil?: string | undefined;
     private?: boolean | undefined;
+    integration?: {
+        __typename: "TaskGithubIntegration";
+        service: "github";
+        identifier: {
+            number: number;
+            type: "Issue" | "PullRequest";
+            id: string;
+            url: string;
+            repositoryOwnerLogin: string;
+            repositoryName: string;
+            __typename: "TaskGithubIntegrationIdentifier";
+        };
+    } | {
+        __typename: "TaskGmailIntegration";
+        service: "gmail";
+        identifier: {
+            id: string;
+            url: string;
+            __typename: "TaskGmailIntegrationIdentifier";
+            messageId: string;
+            accountId: string;
+        };
+    } | undefined;
 }, {
     text: string;
     taskId?: string | undefined;
@@ -72,6 +190,29 @@ export declare const createTaskSchema: z.ZodObject<{
     dueDate?: string | undefined;
     snoozeUntil?: string | undefined;
     private?: boolean | undefined;
+    integration?: {
+        __typename: "TaskGithubIntegration";
+        service: "github";
+        identifier: {
+            number: number;
+            type: "Issue" | "PullRequest";
+            id: string;
+            url: string;
+            repositoryOwnerLogin: string;
+            repositoryName: string;
+            __typename: "TaskGithubIntegrationIdentifier";
+        };
+    } | {
+        __typename: "TaskGmailIntegration";
+        service: "gmail";
+        identifier: {
+            id: string;
+            url: string;
+            __typename: "TaskGmailIntegrationIdentifier";
+            messageId: string;
+            accountId: string;
+        };
+    } | undefined;
 }>;
 export declare const updateTaskCompleteSchema: z.ZodObject<{
     taskId: z.ZodString;
@@ -141,7 +282,7 @@ export declare const updateTaskPlannedTimeSchema: z.ZodObject<{
     timeEstimateMinutes: number;
     limitResponsePayload?: boolean | undefined;
 }>;
-export declare const updateTaskNotesSchema: z.ZodEffects<z.ZodObject<{
+export declare const updateTaskNotesSchema: z.ZodObject<{
     taskId: z.ZodString;
     html: z.ZodOptional<z.ZodString>;
     markdown: z.ZodOptional<z.ZodString>;
@@ -156,16 +297,6 @@ export declare const updateTaskNotesSchema: z.ZodEffects<z.ZodObject<{
     limitResponsePayload?: boolean | undefined;
     html?: string | undefined;
     markdown?: string | undefined;
-}>, {
-    taskId: string;
-    limitResponsePayload?: boolean | undefined;
-    html?: string | undefined;
-    markdown?: string | undefined;
-}, {
-    taskId: string;
-    limitResponsePayload?: boolean | undefined;
-    html?: string | undefined;
-    markdown?: string | undefined;
 }>;
 export declare const updateTaskDueDateSchema: z.ZodObject<{
     taskId: z.ZodString;

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAGH,eAAO,MAAM,sBAAsB,+CAIjC,CAAC;AAGH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAW9B,CAAC;AAGH,eAAO,MAAM,qBAAqB,gDAAe,CAAC;AAGlD,eAAO,MAAM,sBAAsB;;;;;;;;;EAOjC,CAAC;AAGH,eAAO,MAAM,iBAAiB;;;;;;EAI5B,CAAC;AAEH;;GAEG;AAGH,eAAO,MAAM,aAAa,gDAAe,CAAC;AAE1C;;GAEG;AAGH,eAAO,MAAM,gBAAgB,gDAAe,CAAC;AAE7C;;GAEG;AAGH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB3B,CAAC;AAGH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAUnC,CAAC;AAGH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAU3B,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAarC,CAAC;AAGH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAUlC,CAAC;AAGH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;EAUtC,CAAC;AAGH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;EAwBjC,CAAC;AAGF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAalC,CAAC;AAGH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAa/B,CAAC;AAGH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAUjC,CAAC;AAEH;;GAEG;AAGH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AAGH,eAAO,MAAM,WAAW;;;;;;;;;;;;EAItB,CAAC;AAGH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKrB,CAAC;AAGH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYrB,CAAC;AAGH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;EAQvB,CAAC;AAEH;;GAEG;AAGH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7B,CAAC;AAGH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG9B,CAAC;AAGH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC3E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC/E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,0BAA0B,CAClC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,2BAA2B,CACnC,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/schemas.js

@@ -35,6 +35,44 @@ export const getUserSchema = z.object({});
  */
 // Get streams parameters (no parameters needed, uses cached group ID)
 export const getStreamsSchema = z.object({});
+/**
+ * Task Integration Schemas
+ */
+// GitHub integration identifier schema
+const githubIntegrationIdentifierSchema = z.object({
+    id: z.string().describe("GitHub issue or PR ID"),
+    repositoryOwnerLogin: z.string().describe("GitHub repository owner login"),
+    repositoryName: z.string().describe("GitHub repository name"),
+    number: z.number().int().describe("GitHub issue or PR number"),
+    type: z.enum(["Issue", "PullRequest"]).describe("Type of GitHub item"),
+    url: z.string().url().describe("URL to the GitHub issue or PR"),
+    __typename: z.literal("TaskGithubIntegrationIdentifier"),
+});
+// GitHub integration schema
+const githubIntegrationSchema = z.object({
+    service: z.literal("github"),
+    identifier: githubIntegrationIdentifierSchema,
+    __typename: z.literal("TaskGithubIntegration"),
+});
+// Gmail integration identifier schema
+const gmailIntegrationIdentifierSchema = z.object({
+    id: z.string().describe("Gmail message ID"),
+    messageId: z.string().describe("Gmail message ID (duplicate of id)"),
+    accountId: z.string().describe("Gmail account ID"),
+    url: z.string().url().describe("URL to the Gmail message"),
+    __typename: z.literal("TaskGmailIntegrationIdentifier"),
+});
+// Gmail integration schema
+const gmailIntegrationSchema = z.object({
+    service: z.literal("gmail"),
+    identifier: gmailIntegrationIdentifierSchema,
+    __typename: z.literal("TaskGmailIntegration"),
+});
+// Union schema for all task integrations
+const taskIntegrationSchema = z.discriminatedUnion("service", [
+    githubIntegrationSchema,
+    gmailIntegrationSchema,
+]);
 /**
  * Task Mutation Operation Schemas
  */
@@ -48,6 +86,7 @@ export const createTaskSchema = z.object({
     snoozeUntil: z.string().optional().describe("Snooze until date string (ISO format) - the date the task is scheduled for"),
     private: z.boolean().optional().describe("Whether the task is private"),
     taskId: z.string().optional().describe("Custom task ID (auto-generated if not provided)"),
+    integration: taskIntegrationSchema.optional().describe("Integration information for linking task to external services (GitHub, Gmail, etc.)"),
 });
 // Update task complete parameters
 export const updateTaskCompleteSchema = z.object({
@@ -80,20 +119,14 @@ export const updateTaskPlannedTimeSchema = z.object({
     timeEstimateMinutes: z.number().int().min(0).describe("Time estimate in minutes (use 0 to clear the time estimate)"),
     limitResponsePayload: z.boolean().optional().describe("Whether to limit the response payload size"),
 });
-// Update task notes parameters with XOR content validation
+// Update task notes parameters
+// Note: XOR validation between html/markdown is done in the tool execute function
+// to keep the schema as a plain ZodObject (required for MCP SDK compatibility)
 export const updateTaskNotesSchema = z.object({
     taskId: z.string().min(1, "Task ID is required").describe("The ID of the task to update notes for"),
     html: z.string().optional().describe("HTML content for the task notes (mutually exclusive with markdown)"),
     markdown: z.string().optional().describe("Markdown content for the task notes (mutually exclusive with html)"),
     limitResponsePayload: z.boolean().optional().describe("Whether to limit the response payload size (defaults to true)"),
-}).refine((data) => {
-    // Exactly one of html or markdown must be provided
-    const hasHtml = data.html !== undefined;
-    const hasMarkdown = data.markdown !== undefined;
-    return hasHtml !== hasMarkdown; // XOR: exactly one must be true
-}, {
-    message: "Exactly one of 'html' or 'markdown' must be provided",
-    path: [], // This will show the error at the root level
 });
 // Update task due date parameters
 export const updateTaskDueDateSchema = z.object({

package/dist/tools/task-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-tools.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,mBAAmB;;;;;CAU9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;CAqB5B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;CA2B/B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;CAS1B,CAAC;AAGH,eAAO,MAAM,cAAc;;;;;CAoCzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;CAqBzB,CAAC;AAGH,eAAO,MAAM,sBAAsB;;;;;CAqBjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;CA6BnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;CA2BhC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;CAsBpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;CAiC9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;CAsBhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;CA8B7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;CAsB/B,CAAC;AAGH,eAAO,MAAM,SAAS;;;;;GAoBrB,CAAC"}
+{"version":3,"file":"task-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-tools.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,mBAAmB;;;;;CAU9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;CAqB5B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;CA2B/B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;CAS1B,CAAC;AAGH,eAAO,MAAM,cAAc;;;;;CAsCzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;CAqBzB,CAAC;AAGH,eAAO,MAAM,sBAAsB;;;;;CAqBjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;CA6BnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;CA2BhC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;CAsBpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;CAwC9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;CAsBhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;CA8B7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;CAsB/B,CAAC;AAGH,eAAO,MAAM,SAAS;;;;;GAoBrB,CAAC"}

package/dist/tools/task-tools.js

@@ -64,7 +64,7 @@ export const createTaskTool = withTransportClient({
     name: "create-task",
     description: "Create a new task with optional properties",
     parameters: createTaskSchema,
-    execute: async ({ text, notes, streamIds, timeEstimate, dueDate, snoozeUntil, private: isPrivate, taskId, }, context) => {
+    execute: async ({ text, notes, streamIds, timeEstimate, dueDate, snoozeUntil, private: isPrivate, taskId, integration, }, context) => {
         const options = {};
         if (notes)
             options.notes = notes;
@@ -80,6 +80,8 @@ export const createTaskTool = withTransportClient({
             options.private = isPrivate;
         if (taskId)
             options.taskId = taskId;
+        if (integration)
+            options.integration = integration;
         const result = await context.client.createTask(text, options);
         return formatJsonResponse({
             success: result.success,
@@ -178,6 +180,12 @@ export const updateTaskNotesTool = withTransportClient({
     description: "Update the notes content for a task",
     parameters: updateTaskNotesSchema,
     execute: async ({ taskId, html, markdown, limitResponsePayload }, context) => {
+        // XOR validation: exactly one of html or markdown must be provided
+        const hasHtml = html !== undefined;
+        const hasMarkdown = markdown !== undefined;
+        if (hasHtml === hasMarkdown) {
+            throw new Error("Exactly one of 'html' or 'markdown' must be provided");
+        }
         const content = html
             ? { type: "html", value: html }
             : { type: "markdown", value: markdown };

package/dist/transports/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAI/D,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAgCnD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,iBA4O5D"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAgCnD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,iBA4O5D"}

package/dist/transports/http.js

@@ -1,12 +1,13 @@
-import express from "express";
-import cors from "cors";
-import { randomUUID } from "node:crypto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
-import { authenticateHttpRequest, startClientCacheCleanup, stopClientCacheCleanup, cleanupAllClients, } from "../auth/http.js";
-import { SessionManager } from "../session/session-manager.js";
+import cors from "cors";
+import express from "express";
+import { randomUUID } from "node:crypto";
+import { authenticateHttpRequest, cleanupAllClients, startClientCacheCleanup, stopClientCacheCleanup, } from "../auth/http.js";
 import { getSessionConfig } from "../config/session-config.js";
+import { PACKAGE_NAME, VERSION } from "../constants.js";
+import { SessionManager } from "../session/session-manager.js";
 // Unified session management
 export const sessionManager = new SessionManager();
 // Configuration - loaded from environment
@@ -52,8 +53,8 @@ export async function setupHttpTransport(server, config) {
     // Health check endpoint
     app.get("/", (req, res) => {
         res.json({
-            name: "mcp-sunsama",
-            version: "0.15.0",
+            name: PACKAGE_NAME,
+            version: VERSION,
             transport: "http",
             activeSessions: sessionManager.getSessionCount(),
         });

package/glama.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": [
+    "robertn702"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-sunsama",
-  "version": "0.15.4",
+  "version": "0.16.1",
   "description": "MCP server for Sunsama API integration",
   "type": "module",
   "private": false,
@@ -16,15 +16,17 @@
     "test:integration": "bun test --test-name-pattern 'Integration Tests'",
     "test:all": "bun test",
     "test:watch": "bun test --watch --test-name-pattern '^(?!.*Integration Tests).*$'",
-    "typecheck": "bunx tsc --noEmit",
-    "typecheck:watch": "bunx tsc --noEmit --watch",
-    "build": "bunx tsc",
+    "typecheck": "tsc --noEmit",
+    "typecheck:watch": "tsc --noEmit --watch",
+    "clean": "rm -rf dist",
+    "build": "tsc",
+    "build:clean": "npm run clean && npm run build",
     "postbuild": "chmod +x dist/main.js",
     "inspect": "bunx @modelcontextprotocol/inspector --config ./mcp-inspector.json --server sunsama",
     "changeset": "changeset",
-    "version": "changeset version",
-    "release": "bun run build && changeset publish",
-    "prepublishOnly": "bun run build"
+    "version": "changeset version && bun scripts/sync-version.ts",
+    "release": "npm run build && changeset publish",
+    "prepublishOnly": "npm run build:clean"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.18.2",
@@ -32,7 +34,7 @@
     "cors": "^2.8.5",
     "express": "^5.1.0",
     "papaparse": "^5.5.3",
-    "sunsama-api": "0.11.2",
+    "sunsama-api": "0.12.1",
     "zod": "3.24.4"
   },
   "devDependencies": {

package/scripts/sync-version.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env bun
+/**
+ * Syncs the version from package.json to src/constants.ts
+ * Run automatically as part of `bun run version`
+ */
+
+import { readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+
+const ROOT_DIR = join(import.meta.dirname, "..");
+const PACKAGE_JSON_PATH = join(ROOT_DIR, "package.json");
+const CONSTANTS_PATH = join(ROOT_DIR, "src", "constants.ts");
+
+// Read version from package.json
+const packageJson = JSON.parse(readFileSync(PACKAGE_JSON_PATH, "utf-8"));
+const version = packageJson.version;
+
+// Read constants.ts
+let constantsContent = readFileSync(CONSTANTS_PATH, "utf-8");
+
+// Replace VERSION value
+const versionRegex = /export const VERSION = "[^"]+";/;
+const newVersionLine = `export const VERSION = "${version}";`;
+
+if (!versionRegex.test(constantsContent)) {
+  console.error("Could not find VERSION export in constants.ts");
+  process.exit(1);
+}
+
+constantsContent = constantsContent.replace(versionRegex, newVersionLine);
+
+// Write back
+writeFileSync(CONSTANTS_PATH, constantsContent);
+
+console.log(`Synced VERSION to ${version} in src/constants.ts`);

package/smithery.yaml

@@ -0,0 +1,9 @@
+runtime: "container"
+startCommand:
+  type: "http"
+build:
+  dockerfile: "Dockerfile"
+  dockerBuildPath: "."
+env:
+  TRANSPORT_MODE: "http"
+  PORT: "3000"

package/src/constants.ts

@@ -0,0 +1,10 @@
+/**
+ * Application constants
+ *
+ * VERSION is automatically synced from package.json by scripts/sync-version.ts
+ * when running `bun run version`
+ */
+
+export const VERSION = "0.16.1";
+export const SERVER_NAME = "Sunsama API Server";
+export const PACKAGE_NAME = "mcp-sunsama";

package/src/main.ts

@@ -5,12 +5,13 @@ import { setupStdioTransport } from "./transports/stdio.js";
 import { setupHttpTransport } from "./transports/http.js";
 import { allTools } from "./tools/index.js";
 import { apiDocumentationResource } from "./resources/index.js";
+import { VERSION, SERVER_NAME } from "./constants.js";
 
 // Async IIFE for top-level await and error handling
 (async () => {
   const server = new McpServer({
-    name: "Sunsama API Server",
-    version: "0.15.4",
+    name: SERVER_NAME,
+    version: VERSION,
     instructions: `
 This MCP server provides access to the Sunsama API for task and project management.
 

package/src/schemas.ts

@@ -59,6 +59,50 @@ export const getUserSchema = z.object({});
 // Get streams parameters (no parameters needed, uses cached group ID)
 export const getStreamsSchema = z.object({});
 
+/**
+ * Task Integration Schemas
+ */
+
+// GitHub integration identifier schema
+const githubIntegrationIdentifierSchema = z.object({
+  id: z.string().describe("GitHub issue or PR ID"),
+  repositoryOwnerLogin: z.string().describe("GitHub repository owner login"),
+  repositoryName: z.string().describe("GitHub repository name"),
+  number: z.number().int().describe("GitHub issue or PR number"),
+  type: z.enum(["Issue", "PullRequest"]).describe("Type of GitHub item"),
+  url: z.string().url().describe("URL to the GitHub issue or PR"),
+  __typename: z.literal("TaskGithubIntegrationIdentifier"),
+});
+
+// GitHub integration schema
+const githubIntegrationSchema = z.object({
+  service: z.literal("github"),
+  identifier: githubIntegrationIdentifierSchema,
+  __typename: z.literal("TaskGithubIntegration"),
+});
+
+// Gmail integration identifier schema
+const gmailIntegrationIdentifierSchema = z.object({
+  id: z.string().describe("Gmail message ID"),
+  messageId: z.string().describe("Gmail message ID (duplicate of id)"),
+  accountId: z.string().describe("Gmail account ID"),
+  url: z.string().url().describe("URL to the Gmail message"),
+  __typename: z.literal("TaskGmailIntegrationIdentifier"),
+});
+
+// Gmail integration schema
+const gmailIntegrationSchema = z.object({
+  service: z.literal("gmail"),
+  identifier: gmailIntegrationIdentifierSchema,
+  __typename: z.literal("TaskGmailIntegration"),
+});
+
+// Union schema for all task integrations
+const taskIntegrationSchema = z.discriminatedUnion("service", [
+  githubIntegrationSchema,
+  gmailIntegrationSchema,
+]);
+
 /**
  * Task Mutation Operation Schemas
  */
@@ -83,6 +127,9 @@ export const createTaskSchema = z.object({
   taskId: z.string().optional().describe(
     "Custom task ID (auto-generated if not provided)",
   ),
+  integration: taskIntegrationSchema.optional().describe(
+    "Integration information for linking task to external services (GitHub, Gmail, etc.)",
+  ),
 });
 
 // Update task complete parameters
@@ -153,7 +200,9 @@ export const updateTaskPlannedTimeSchema = z.object({
   ),
 });
 
-// Update task notes parameters with XOR content validation
+// Update task notes parameters
+// Note: XOR validation between html/markdown is done in the tool execute function
+// to keep the schema as a plain ZodObject (required for MCP SDK compatibility)
 export const updateTaskNotesSchema = z.object({
   taskId: z.string().min(1, "Task ID is required").describe(
     "The ID of the task to update notes for",
@@ -167,18 +216,7 @@ export const updateTaskNotesSchema = z.object({
   limitResponsePayload: z.boolean().optional().describe(
     "Whether to limit the response payload size (defaults to true)",
   ),
-}).refine(
-  (data) => {
-    // Exactly one of html or markdown must be provided
-    const hasHtml = data.html !== undefined;
-    const hasMarkdown = data.markdown !== undefined;
-    return hasHtml !== hasMarkdown; // XOR: exactly one must be true
-  },
-  {
-    message: "Exactly one of 'html' or 'markdown' must be provided",
-    path: [], // This will show the error at the root level
-  },
-);
+});
 
 // Update task due date parameters
 export const updateTaskDueDateSchema = z.object({

package/src/tools/task-tools.ts

@@ -130,6 +130,7 @@ export const createTaskTool = withTransportClient({
       snoozeUntil,
       private: isPrivate,
       taskId,
+      integration,
     }: CreateTaskInput,
     context: ToolContext,
   ) => {
@@ -141,6 +142,7 @@ export const createTaskTool = withTransportClient({
     if (snoozeUntil) options.snoozeUntil = snoozeUntil;
     if (isPrivate !== undefined) options.private = isPrivate;
     if (taskId) options.taskId = taskId;
+    if (integration) options.integration = integration;
 
     const result = await context.client.createTask(text, options);
 
@@ -293,6 +295,13 @@ export const updateTaskNotesTool = withTransportClient({
     { taskId, html, markdown, limitResponsePayload }: UpdateTaskNotesInput,
     context: ToolContext,
   ) => {
+    // XOR validation: exactly one of html or markdown must be provided
+    const hasHtml = html !== undefined;
+    const hasMarkdown = markdown !== undefined;
+    if (hasHtml === hasMarkdown) {
+      throw new Error("Exactly one of 'html' or 'markdown' must be provided");
+    }
+
     const content = html
       ? { type: "html" as const, value: html }
       : { type: "markdown" as const, value: markdown! };

package/src/transports/http.ts

@@ -1,19 +1,20 @@
-import express from "express";
-import cors from "cors";
-import { randomUUID } from "node:crypto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import cors from "cors";
+import express from "express";
+import { randomUUID } from "node:crypto";
 import {
   authenticateHttpRequest,
+  cleanupAllClients,
   startClientCacheCleanup,
   stopClientCacheCleanup,
-  cleanupAllClients,
 } from "../auth/http.js";
-import type { TransportConfig } from "../config/transport.js";
 import type { SessionData } from "../auth/types.js";
-import { SessionManager } from "../session/session-manager.js";
 import { getSessionConfig } from "../config/session-config.js";
+import type { TransportConfig } from "../config/transport.js";
+import { PACKAGE_NAME, VERSION } from "../constants.js";
+import { SessionManager } from "../session/session-manager.js";
 
 // Unified session management
 export const sessionManager = new SessionManager();
@@ -69,13 +70,13 @@ export async function setupHttpTransport(
     })
   );
 
-  app.use(express.json({ limit: "4mb" }));
+  app.use(express.json({limit: "4mb"}));
 
   // Health check endpoint
   app.get("/", (req, res) => {
     res.json({
-      name: "mcp-sunsama",
-      version: "0.15.0",
+      name: PACKAGE_NAME,
+      version: VERSION,
       transport: "http",
       activeSessions: sessionManager.getSessionCount(),
     });
@@ -248,7 +249,7 @@ export async function setupHttpTransport(
     }
   });
 
-  const { port } = config.httpStream;
+  const {port} = config.httpStream;
 
   // Start cleanup timers
   startClientCacheCleanup();

package/tsconfig.json

@@ -32,6 +32,7 @@
   "exclude": [
     "dist",
     "node_modules",
-    "__tests__"
+    "__tests__",
+    "scripts"
   ]
 }