mcp-sunsama 0.15.3 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # mcp-sunsama
 
+## 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
+
+- eb40ca5: Fix executable permissions on bin file by adding postbuild script. Adds chmod +x to ensure dist/main.js is executable after build, resolving 'Permission denied' error when running via npx.
+
 ## 0.15.3
 
 ### Patch Changes

package/CLAUDE.md

@@ -89,6 +89,14 @@ All tools use Zod schemas from `schemas.ts`:
 - 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
+- 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 +157,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 +201,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**:
@@ -244,7 +252,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.
 

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

@@ -9,7 +9,7 @@
         "cors": "^2.8.5",
         "express": "^5.1.0",
         "papaparse": "^5.5.3",
-        "sunsama-api": "0.11.2",
+        "sunsama-api": "0.12.0",
         "zod": "3.24.4",
       },
       "devDependencies": {
@@ -396,7 +396,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.0", "", { "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-J2nXZAlYnlA567fmfpwWAOqZnOO0FLVfRwskJQ+gngrjpq26E5TamGSQZ4317/UdJ3U87ZnJdyoHnBRjjBdtvA=="],
 
     "term-size": ["term-size@2.2.1", "", {}, "sha512-wK0Ri4fOGjv/XPy8SBHZChl8CM7uMc5VML7SqiQ0zG7+J5Vr+RMQDoHa2CNT6KHUnTGIXH34UDMkPzAUyapBZg=="],
 

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Application constants
+ *
+ * IMPORTANT: Keep VERSION in sync with package.json version
+ */
+export declare const VERSION = "0.16.0";
+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;;;;GAIG;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,8 @@
+/**
+ * Application constants
+ *
+ * IMPORTANT: Keep VERSION in sync with package.json version
+ */
+export const VERSION = "0.16.0";
+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.3",
+        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;

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}
+{"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({

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;;;;;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"}

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,

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.3",
+  "version": "0.16.0",
   "description": "MCP server for Sunsama API integration",
   "type": "module",
   "private": false,
@@ -16,14 +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"
+    "release": "npm run build && changeset publish",
+    "prepublishOnly": "npm run build:clean"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.18.2",
@@ -31,7 +34,7 @@
     "cors": "^2.8.5",
     "express": "^5.1.0",
     "papaparse": "^5.5.3",
-    "sunsama-api": "0.11.2",
+    "sunsama-api": "0.12.0",
     "zod": "3.24.4"
   },
   "devDependencies": {

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,9 @@
+/**
+ * Application constants
+ *
+ * IMPORTANT: Keep VERSION in sync with package.json version
+ */
+
+export const VERSION = "0.16.0";
+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.3",
+    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

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);
 

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();