@tenonhq/dovetail-mcp 0.0.1

package/dist/tools/calendar.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Calendar read-only MCP tools.
+ *
+ * Imports only read functions. createEvent, updateEvent, deleteEvent are
+ * forbidden by ESLint and asserted absent by readonly-imports test.
+ */
+import type { OAuth2Client } from "google-auth-library";
+import type { CalendarClient } from "@tenonhq/dovetail-google-calendar";
+import type { GoogleConfig } from "../config";
+import { CalendarGetTodayInput, CalendarGetWeekInput, CalendarGetEventInput } from "../schemas/calendar";
+export interface CalendarDeps {
+    config: GoogleConfig;
+    authFactory?: (config: GoogleConfig) => OAuth2Client;
+    clientFactory?: (auth: OAuth2Client) => CalendarClient;
+}
+export declare function calendarGetToday(args: CalendarGetTodayInput, deps: CalendarDeps): Promise<any>;
+export declare function calendarGetWeek(args: CalendarGetWeekInput, deps: CalendarDeps): Promise<any>;
+export declare function calendarGetEvent(args: CalendarGetEventInput, deps: CalendarDeps): Promise<any>;

package/dist/tools/calendar.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Calendar read-only MCP tools.
+ *
+ * Imports only read functions. createEvent, updateEvent, deleteEvent are
+ * forbidden by ESLint and asserted absent by readonly-imports test.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calendarGetToday = calendarGetToday;
+exports.calendarGetWeek = calendarGetWeek;
+exports.calendarGetEvent = calendarGetEvent;
+const dovetail_google_auth_1 = require("@tenonhq/dovetail-google-auth");
+const dovetail_google_calendar_1 = require("@tenonhq/dovetail-google-calendar");
+function resolveClient(deps) {
+    var auth;
+    if (deps.authFactory) {
+        auth = deps.authFactory(deps.config);
+    }
+    else {
+        auth = (0, dovetail_google_auth_1.createGoogleAuth)({ config: deps.config }).auth;
+    }
+    if (deps.clientFactory) {
+        return deps.clientFactory(auth);
+    }
+    return (0, dovetail_google_calendar_1.createCalendarClient)({ auth: auth });
+}
+async function calendarGetToday(args, deps) {
+    var client = resolveClient(deps);
+    return await (0, dovetail_google_calendar_1.getTodayEvents)({
+        client: client,
+        calendarId: args.calendarId,
+        timeZone: args.timeZone
+    });
+}
+async function calendarGetWeek(args, deps) {
+    var client = resolveClient(deps);
+    return await (0, dovetail_google_calendar_1.getUpcomingEvents)({
+        client: client,
+        days: 7,
+        maxResults: args.maxResults,
+        calendarId: args.calendarId,
+        timeZone: args.timeZone
+    });
+}
+async function calendarGetEvent(args, deps) {
+    var client = resolveClient(deps);
+    return await (0, dovetail_google_calendar_1.getEvent)({
+        client: client,
+        eventId: args.eventId,
+        calendarId: args.calendarId
+    });
+}

package/dist/tools/clickup.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ClickUp read-only MCP tools.
+ *
+ * Imports only read functions from @tenonhq/dovetail-clickup. createTask,
+ * updateTask, updateTaskStatus, deleteTask, addComment are forbidden by ESLint
+ * (.eslintrc.json) and asserted absent by tests/readonly-imports.test.ts.
+ */
+import type { AxiosInstance } from "axios";
+import type { ClickUpConfig } from "../config";
+import { ClickupListTasksInput, ClickupGetTaskInput, ClickupSearchTasksInput, ClickupGetTeamSyncInput } from "../schemas/clickup";
+import { TeamSyncJson } from "./teamsync";
+export interface ClickUpDeps {
+    config: ClickUpConfig;
+    clientFactory?: (config: ClickUpConfig) => AxiosInstance;
+}
+export declare function clickupListTasks(args: ClickupListTasksInput, deps: ClickUpDeps): Promise<{
+    tasks: any[];
+    byStatus: Record<string, any[]>;
+    total: number;
+}>;
+export declare function clickupGetTask(args: ClickupGetTaskInput, deps: ClickUpDeps): Promise<any>;
+export declare function clickupSearchTasks(args: ClickupSearchTasksInput, deps: ClickUpDeps): Promise<{
+    tasks: any[];
+    total: number;
+    query: string;
+}>;
+export declare function clickupGetTeamSync(args: ClickupGetTeamSyncInput, deps: ClickUpDeps): Promise<TeamSyncJson>;

package/dist/tools/clickup.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * ClickUp read-only MCP tools.
+ *
+ * Imports only read functions from @tenonhq/dovetail-clickup. createTask,
+ * updateTask, updateTaskStatus, deleteTask, addComment are forbidden by ESLint
+ * (.eslintrc.json) and asserted absent by tests/readonly-imports.test.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickupListTasks = clickupListTasks;
+exports.clickupGetTask = clickupGetTask;
+exports.clickupSearchTasks = clickupSearchTasks;
+exports.clickupGetTeamSync = clickupGetTeamSync;
+const dovetail_clickup_1 = require("@tenonhq/dovetail-clickup");
+const teamsync_1 = require("./teamsync");
+function resolveClient(deps) {
+    var factory = deps.clientFactory || (function (cfg) {
+        return (0, dovetail_clickup_1.createClient)({ token: cfg.token });
+    });
+    return factory(deps.config);
+}
+function requireTeamId(deps, override) {
+    var teamId = override || deps.config.defaultTeamId;
+    if (!teamId) {
+        throw new Error("teamId is required — pass it in the tool args or set CLICKUP_TEAM_ID.");
+    }
+    return teamId;
+}
+async function clickupListTasks(args, deps) {
+    var client = resolveClient(deps);
+    var teamId = requireTeamId(deps, args.teamId);
+    var result = await (0, dovetail_clickup_1.listMyTasks)({
+        client: client,
+        teamId: teamId,
+        statuses: args.statuses
+    });
+    return {
+        tasks: result.tasks,
+        byStatus: result.byStatus,
+        total: result.total
+    };
+}
+async function clickupGetTask(args, deps) {
+    var client = resolveClient(deps);
+    return await (0, dovetail_clickup_1.getTask)({ client: client, taskId: args.taskId });
+}
+async function clickupSearchTasks(args, deps) {
+    var client = resolveClient(deps);
+    var teamId = requireTeamId(deps, args.teamId);
+    var result = await (0, dovetail_clickup_1.listTeamTasks)({
+        client: client,
+        teamId: teamId,
+        spaceIds: args.spaceIds,
+        statuses: args.statuses,
+        includeClosed: false
+    });
+    var needle = args.query.toLowerCase();
+    var matched = [];
+    for (var i = 0; i < result.tasks.length; i++) {
+        var task = result.tasks[i];
+        if ((task.name || "").toLowerCase().indexOf(needle) !== -1) {
+            matched.push(task);
+            continue;
+        }
+        if ((task.description || "").toLowerCase().indexOf(needle) !== -1) {
+            matched.push(task);
+        }
+    }
+    return { tasks: matched, total: matched.length, query: args.query };
+}
+async function clickupGetTeamSync(args, deps) {
+    var client = resolveClient(deps);
+    var teamId = requireTeamId(deps, args.teamId);
+    return await (0, teamsync_1.buildTeamSyncJson)({ client: client, teamId: teamId });
+}

package/dist/tools/gmail.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Gmail read-only MCP tools.
+ *
+ * Imports only read functions from @tenonhq/dovetail-gmail. archiveEmail,
+ * labelEmail, markAsRead, markAsUnread, moveToTrash, starEmail, unstarEmail
+ * are forbidden by ESLint and asserted absent by readonly-imports test.
+ */
+import type { OAuth2Client } from "google-auth-library";
+import type { GmailClient } from "@tenonhq/dovetail-gmail";
+import type { GoogleConfig } from "../config";
+import { GmailGetUnreadInput, GmailGetStarredInput, GmailSearchInput, GmailGetActionRequiredInput } from "../schemas/gmail";
+export interface GmailDeps {
+    config: GoogleConfig;
+    authFactory?: (config: GoogleConfig) => OAuth2Client;
+    clientFactory?: (auth: OAuth2Client) => GmailClient;
+}
+export declare function gmailGetUnread(args: GmailGetUnreadInput, deps: GmailDeps): Promise<any>;
+export declare function gmailGetStarred(args: GmailGetStarredInput, deps: GmailDeps): Promise<any>;
+export declare function gmailSearch(args: GmailSearchInput, deps: GmailDeps): Promise<any>;
+export declare function gmailGetActionRequired(args: GmailGetActionRequiredInput, deps: GmailDeps): Promise<any>;

package/dist/tools/gmail.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Gmail read-only MCP tools.
+ *
+ * Imports only read functions from @tenonhq/dovetail-gmail. archiveEmail,
+ * labelEmail, markAsRead, markAsUnread, moveToTrash, starEmail, unstarEmail
+ * are forbidden by ESLint and asserted absent by readonly-imports test.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gmailGetUnread = gmailGetUnread;
+exports.gmailGetStarred = gmailGetStarred;
+exports.gmailSearch = gmailSearch;
+exports.gmailGetActionRequired = gmailGetActionRequired;
+const dovetail_google_auth_1 = require("@tenonhq/dovetail-google-auth");
+const dovetail_gmail_1 = require("@tenonhq/dovetail-gmail");
+function resolveClient(deps) {
+    var auth;
+    if (deps.authFactory) {
+        auth = deps.authFactory(deps.config);
+    }
+    else {
+        auth = (0, dovetail_google_auth_1.createGoogleAuth)({ config: deps.config }).auth;
+    }
+    if (deps.clientFactory) {
+        return deps.clientFactory(auth);
+    }
+    return (0, dovetail_gmail_1.createGmailClient)({ auth: auth });
+}
+async function gmailGetUnread(args, deps) {
+    var client = resolveClient(deps);
+    return await (0, dovetail_gmail_1.getUnread)({
+        client: client,
+        maxResults: args.maxResults,
+        pageToken: args.pageToken
+    });
+}
+async function gmailGetStarred(args, deps) {
+    var client = resolveClient(deps);
+    return await (0, dovetail_gmail_1.getStarred)({
+        client: client,
+        maxResults: args.maxResults,
+        pageToken: args.pageToken
+    });
+}
+async function gmailSearch(args, deps) {
+    var client = resolveClient(deps);
+    return await (0, dovetail_gmail_1.searchEmails)({
+        client: client,
+        query: args.query,
+        maxResults: args.maxResults,
+        pageToken: args.pageToken
+    });
+}
+async function gmailGetActionRequired(args, deps) {
+    var client = resolveClient(deps);
+    return await (0, dovetail_gmail_1.getActionRequired)({
+        client: client,
+        labels: args.labels,
+        subjectPatterns: args.subjectPatterns,
+        maxResults: args.maxResults
+    });
+}

package/dist/tools/servicenow.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ServiceNow read-only MCP tool.
+ *
+ * Imports only createClient from @tenonhq/dovetail-servicenow and uses
+ * exclusively client.table.query() — never client.claude.*, which is the
+ * write surface. addChoicesToField is forbidden by ESLint.
+ *
+ * Tables on the deny list (sys_user_password, sys_credential, sys_audit, …)
+ * are rejected unless the operator opts in via SINC_MCP_SN_TABLE_OVERRIDE.
+ */
+import type { ServiceNowClient } from "@tenonhq/dovetail-servicenow";
+import type { ServiceNowSafetyConfig } from "../config";
+import { ServicenowQueryTableInput } from "../schemas/servicenow";
+export interface ServiceNowDeps {
+    safety: ServiceNowSafetyConfig;
+    clientFactory?: () => ServiceNowClient;
+}
+export declare function servicenowQueryTable(args: ServicenowQueryTableInput, deps: ServiceNowDeps): Promise<{
+    table: string;
+    count: number;
+    records: any[];
+}>;

package/dist/tools/servicenow.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * ServiceNow read-only MCP tool.
+ *
+ * Imports only createClient from @tenonhq/dovetail-servicenow and uses
+ * exclusively client.table.query() — never client.claude.*, which is the
+ * write surface. addChoicesToField is forbidden by ESLint.
+ *
+ * Tables on the deny list (sys_user_password, sys_credential, sys_audit, …)
+ * are rejected unless the operator opts in via SINC_MCP_SN_TABLE_OVERRIDE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.servicenowQueryTable = servicenowQueryTable;
+const dovetail_servicenow_1 = require("@tenonhq/dovetail-servicenow");
+function resolveClient(deps) {
+    if (deps.clientFactory) {
+        return deps.clientFactory();
+    }
+    return (0, dovetail_servicenow_1.createClient)();
+}
+function isDenied(table, safety) {
+    if (safety.denyTables.indexOf(table) === -1) {
+        return false;
+    }
+    return safety.overrideTables.indexOf(table) === -1;
+}
+async function servicenowQueryTable(args, deps) {
+    if (isDenied(args.table, deps.safety)) {
+        throw new Error("Table '" + args.table + "' is in the default deny list. " +
+            "Set SINC_MCP_SN_TABLE_OVERRIDE=" + args.table + " (comma-separated for multiple) to enable.");
+    }
+    var client = resolveClient(deps);
+    var limit = args.limit !== undefined ? args.limit : 100;
+    var records;
+    if (args.fields && args.fields.length > 0) {
+        records = await client.table.query(args.table, args.sysparm_query, {
+            limit: limit,
+            fields: args.fields
+        });
+    }
+    else {
+        records = await client.table.query(args.table, args.sysparm_query, limit);
+    }
+    return { table: args.table, count: records.length, records: records };
+}

package/dist/tools/teamsync.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Builds a structured JSON team sync from listTeamTasks output. Mirrors the
+ * 7-stage pipeline in @tenonhq/dovetail-clickup formatter.ts so the JSON
+ * tool output has the same semantics as the existing markdown formatter,
+ * but as a structured object instead of a string.
+ */
+import type { AxiosInstance } from "axios";
+export declare var STATUS_MAP: Record<string, string>;
+export declare var STAGE_ORDER: string[];
+export interface TeamSyncTask {
+    id: string;
+    customId: string | null;
+    name: string;
+    status: string;
+    url: string;
+    list: string;
+    assignees: string[];
+    dueDate: string | null;
+    dateUpdated: string;
+}
+export interface TeamSyncStage {
+    stage: string;
+    count: number;
+    tasks: TeamSyncTask[];
+}
+export interface TeamSyncJson {
+    syncTime: string;
+    total: number;
+    totalLists: number;
+    stages: TeamSyncStage[];
+    unmappedStatuses: Record<string, number>;
+    unassigned: TeamSyncTask[];
+}
+export interface BuildTeamSyncDeps {
+    client: AxiosInstance;
+    teamId: string;
+}
+export declare function buildTeamSyncJson(deps: BuildTeamSyncDeps): Promise<TeamSyncJson>;

package/dist/tools/teamsync.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Builds a structured JSON team sync from listTeamTasks output. Mirrors the
+ * 7-stage pipeline in @tenonhq/dovetail-clickup formatter.ts so the JSON
+ * tool output has the same semantics as the existing markdown formatter,
+ * but as a structured object instead of a string.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STAGE_ORDER = exports.STATUS_MAP = void 0;
+exports.buildTeamSyncJson = buildTeamSyncJson;
+const dovetail_clickup_1 = require("@tenonhq/dovetail-clickup");
+exports.STATUS_MAP = {
+    blocked: "Blocked",
+    "in progress": "In Progress",
+    "in review": "In Review",
+    qa: "QA",
+    uat: "UAT",
+    "ready for release": "Ready for Release",
+    done: "Done"
+};
+exports.STAGE_ORDER = [
+    "Blocked",
+    "In Progress",
+    "In Review",
+    "QA",
+    "UAT",
+    "Ready for Release",
+    "Done"
+];
+async function buildTeamSyncJson(deps) {
+    var result = await (0, dovetail_clickup_1.listTeamTasks)({
+        client: deps.client,
+        teamId: deps.teamId,
+        includeClosed: false
+    });
+    var stages = {};
+    var unmapped = {};
+    var unassigned = [];
+    var listIds = {};
+    for (var i = 0; i < result.tasks.length; i++) {
+        var task = result.tasks[i];
+        var statusName = task.status && task.status.status ? task.status.status : "unknown";
+        var stageName = exports.STATUS_MAP[statusName.toLowerCase()];
+        var entry = toTeamSyncTask(task);
+        if (entry.list) {
+            listIds[entry.list] = true;
+        }
+        if (!stageName) {
+            unmapped[statusName] = (unmapped[statusName] || 0) + 1;
+            continue;
+        }
+        if (!stages[stageName]) {
+            stages[stageName] = [];
+        }
+        stages[stageName].push(entry);
+    }
+    for (var u = 0; u < result.unassigned.length; u++) {
+        unassigned.push(toTeamSyncTask(result.unassigned[u]));
+    }
+    var orderedStages = [];
+    for (var s = 0; s < exports.STAGE_ORDER.length; s++) {
+        var name = exports.STAGE_ORDER[s];
+        var tasks = stages[name] || [];
+        tasks.sort(function (a, b) {
+            return parseInt(b.dateUpdated, 10) - parseInt(a.dateUpdated, 10);
+        });
+        orderedStages.push({ stage: name, count: tasks.length, tasks: tasks });
+    }
+    return {
+        syncTime: new Date().toISOString(),
+        total: result.total,
+        totalLists: Object.keys(listIds).length,
+        stages: orderedStages,
+        unmappedStatuses: unmapped,
+        unassigned: unassigned
+    };
+}
+function toTeamSyncTask(task) {
+    var assignees = [];
+    if (task.assignees && task.assignees.length > 0) {
+        for (var i = 0; i < task.assignees.length; i++) {
+            var a = task.assignees[i];
+            assignees.push(a.username || a.email || String(a.id));
+        }
+    }
+    return {
+        id: task.id,
+        customId: task.custom_id || null,
+        name: task.name,
+        status: task.status && task.status.status ? task.status.status : "unknown",
+        url: task.url || "",
+        list: task.list && task.list.name ? task.list.name : "",
+        assignees: assignees,
+        dueDate: task.due_date || null,
+        dateUpdated: task.date_updated || "0"
+    };
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@tenonhq/dovetail-mcp",
+  "version": "0.0.1",
+  "description": "MCP server exposing read-only ClickUp / Gmail / Calendar / ServiceNow tools backed by the Dovetail integration packages.",
+  "main": "./dist/index.js",
+  "bin": {
+    "dove-mcp": "./dist/server.js",
+    "sinc-mcp": "./dist/server.js"
+  },
+  "scripts": {
+    "test": "jest",
+    "prepack": "tsc",
+    "version:bump": "node ./../../Scripts/bump-version.js ./package.json",
+    "postpublish": "npm run version:bump"
+  },
+  "author": "Tenon",
+  "license": "GPL-3.0",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@tenonhq/dovetail-clickup": "^0.0.7",
+    "@tenonhq/dovetail-gmail": "^0.0.7",
+    "@tenonhq/dovetail-google-auth": "^0.0.9",
+    "@tenonhq/dovetail-google-calendar": "^0.0.7",
+    "@tenonhq/dovetail-servicenow": "^0.0.2",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "@types/node": ">=20.8.4",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.2.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tenonhq/dovetail.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tenonhq/dovetail/issues"
+  }
+}