@vineethnkrishnan/linear-mcp 0.1.1

package/build/common/types.d.ts

@@ -0,0 +1,10 @@
+export interface LinearConfig {
+    apiKey: string;
+}
+export interface McpToolResponse {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}

package/build/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/common/types.js.map

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

package/build/common/utils.d.ts

@@ -0,0 +1,38 @@
+import { McpToolResponse } from "./types";
+/**
+ * Converts GraphQL connection structures ({nodes: [...], pageInfo: {...}})
+ * to plain arrays. Handles nested connections recursively.
+ */
+export declare function flattenConnection(data: unknown): unknown;
+/**
+ * Simplifies nested references on a node by stripping __typename fields.
+ * Preserves structure like {assignee: {id, name}} but removes GraphQL metadata.
+ */
+export declare function flattenNode(node: unknown): unknown;
+/**
+ * Maps numeric priority values to human-readable labels.
+ * Returns the label string, or the original value if not a known priority.
+ */
+export declare function mapPriority(priority: number): string;
+/**
+ * Recursively maps priority fields in an object from numeric to labeled format.
+ */
+export declare function mapPriorities(data: unknown): unknown;
+/**
+ * Recursively removes __typename, pageInfo, and other GraphQL metadata
+ * from all levels of an object.
+ */
+export declare function stripGraphQLMetadata(obj: unknown, keys?: string[]): unknown;
+/**
+ * Composes all Linear-specific transformations for LLM optimization.
+ * Order: flatten connections -> strip metadata -> map priorities
+ */
+export declare function transformLinearResponse(data: unknown): unknown;
+/**
+ * Transforms Linear data and wraps it in the MCP tool response format.
+ */
+export declare function formatMcpResponse(data: unknown): McpToolResponse;
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+export declare function formatMcpError(error: unknown): McpToolResponse;

package/build/common/utils.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenConnection = flattenConnection;
+exports.flattenNode = flattenNode;
+exports.mapPriority = mapPriority;
+exports.mapPriorities = mapPriorities;
+exports.stripGraphQLMetadata = stripGraphQLMetadata;
+exports.transformLinearResponse = transformLinearResponse;
+exports.formatMcpResponse = formatMcpResponse;
+exports.formatMcpError = formatMcpError;
+const LINEAR_STRIP_KEYS = [
+    "__typename",
+    "pageInfo",
+    "archivedAt",
+    "trashed",
+    "autoArchivedAt",
+    "autoClosedAt",
+    "snoozedUntilAt",
+    "sortOrder",
+    "boardOrder",
+    "subIssueSortOrder",
+];
+const PRIORITY_MAP = {
+    0: "No Priority",
+    1: "Urgent",
+    2: "High",
+    3: "Medium",
+    4: "Low",
+};
+/**
+ * Converts GraphQL connection structures ({nodes: [...], pageInfo: {...}})
+ * to plain arrays. Handles nested connections recursively.
+ */
+function flattenConnection(data) {
+    if (data === null || data === undefined)
+        return data;
+    if (Array.isArray(data))
+        return data.map(flattenConnection);
+    if (typeof data !== "object")
+        return data;
+    const record = data;
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (value !== null &&
+            typeof value === "object" &&
+            !Array.isArray(value) &&
+            "nodes" in value) {
+            const connection = value;
+            const nodes = connection.nodes;
+            result[key] = nodes.map(flattenConnection);
+        }
+        else {
+            result[key] = flattenConnection(value);
+        }
+    }
+    return result;
+}
+/**
+ * Simplifies nested references on a node by stripping __typename fields.
+ * Preserves structure like {assignee: {id, name}} but removes GraphQL metadata.
+ */
+function flattenNode(node) {
+    if (node === null || node === undefined)
+        return node;
+    if (Array.isArray(node))
+        return node.map(flattenNode);
+    if (typeof node !== "object")
+        return node;
+    const record = node;
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (key === "__typename")
+            continue;
+        result[key] = flattenNode(value);
+    }
+    return result;
+}
+/**
+ * Maps numeric priority values to human-readable labels.
+ * Returns the label string, or the original value if not a known priority.
+ */
+function mapPriority(priority) {
+    return PRIORITY_MAP[priority] ?? `Unknown (${priority})`;
+}
+/**
+ * Recursively maps priority fields in an object from numeric to labeled format.
+ */
+function mapPriorities(data) {
+    if (data === null || data === undefined)
+        return data;
+    if (Array.isArray(data))
+        return data.map(mapPriorities);
+    if (typeof data !== "object")
+        return data;
+    const record = data;
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (key === "priority" && typeof value === "number") {
+            result[key] = { level: value, label: mapPriority(value) };
+        }
+        else {
+            result[key] = mapPriorities(value);
+        }
+    }
+    return result;
+}
+/**
+ * Recursively removes __typename, pageInfo, and other GraphQL metadata
+ * from all levels of an object.
+ */
+function stripGraphQLMetadata(obj, keys = LINEAR_STRIP_KEYS) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map((item) => stripGraphQLMetadata(item, keys));
+    if (typeof obj !== "object")
+        return obj;
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (keys.includes(key))
+            continue;
+        result[key] = stripGraphQLMetadata(value, keys);
+    }
+    return result;
+}
+/**
+ * Composes all Linear-specific transformations for LLM optimization.
+ * Order: flatten connections -> strip metadata -> map priorities
+ */
+function transformLinearResponse(data) {
+    let result = flattenConnection(data);
+    result = stripGraphQLMetadata(result);
+    result = mapPriorities(result);
+    return result;
+}
+/**
+ * Transforms Linear data and wraps it in the MCP tool response format.
+ */
+function formatMcpResponse(data) {
+    const transformed = transformLinearResponse(data);
+    return {
+        content: [{ type: "text", text: JSON.stringify(transformed, null, 2) }],
+    };
+}
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+function formatMcpError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/build/common/utils.js.map

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

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const zod_1 = require("zod");
+const linear_service_1 = require("./services/linear.service");
+const issue_tools_1 = require("./tools/issue.tools");
+const project_tools_1 = require("./tools/project.tools");
+const team_tools_1 = require("./tools/team.tools");
+// Validate required config
+const LINEAR_API_KEY = process.env.LINEAR_API_KEY;
+if (!LINEAR_API_KEY) {
+    console.error("LINEAR_API_KEY environment variable is required.");
+    process.exit(1);
+}
+const linearService = new linear_service_1.LinearService({
+    apiKey: LINEAR_API_KEY,
+});
+// Initialize tool classes
+const tools = {
+    issues: new issue_tools_1.IssueTools(linearService),
+    projects: new project_tools_1.ProjectTools(linearService),
+    teams: new team_tools_1.TeamTools(linearService),
+};
+// Combine all schemas
+const AllToolSchemas = {
+    ...issue_tools_1.IssueToolSchemas,
+    ...project_tools_1.ProjectToolSchemas,
+    ...team_tools_1.TeamToolSchemas,
+};
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version } = require("../package.json");
+const server = new index_js_1.Server({
+    name: "linear-mcp",
+    version,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+/**
+ * Handler for listing available tools.
+ */
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: Object.entries(AllToolSchemas).map(([name, config]) => ({
+            name,
+            description: config.description,
+            inputSchema: zod_1.z.toJSONSchema(config.schema),
+        })),
+    };
+});
+const toolRegistry = {};
+for (const name of Object.keys(issue_tools_1.IssueToolSchemas)) {
+    toolRegistry[name] = (args) => tools.issues[name](args);
+}
+for (const name of Object.keys(project_tools_1.ProjectToolSchemas)) {
+    toolRegistry[name] = (args) => tools.projects[name](args);
+}
+for (const name of Object.keys(team_tools_1.TeamToolSchemas)) {
+    toolRegistry[name] = (args) => tools.teams[name](args);
+}
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        const handler = toolRegistry[name];
+        if (!handler) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Tool not found: ${name}`);
+        }
+        return await handler(args ?? {});
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+/**
+ * Start the server using Stdio transport.
+ */
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Linear MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,wEAAmE;AACnE,wEAAiF;AACjF,iEAK4C;AAC5C,6BAAwB;AACxB,8DAA0D;AAC1D,qDAAmE;AACnE,yDAAyE;AACzE,mDAAgE;AAEhE,2BAA2B;AAC3B,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AAElD,IAAI,CAAC,cAAc,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,aAAa,GAAG,IAAI,8BAAa,CAAC;IACtC,MAAM,EAAE,cAAc;CACvB,CAAC,CAAC;AAEH,0BAA0B;AAC1B,MAAM,KAAK,GAAG;IACZ,MAAM,EAAE,IAAI,wBAAU,CAAC,aAAa,CAAC;IACrC,QAAQ,EAAE,IAAI,4BAAY,CAAC,aAAa,CAAC;IACzC,KAAK,EAAE,IAAI,sBAAS,CAAC,aAAa,CAAC;CACpC,CAAC;AAEF,sBAAsB;AACtB,MAAM,cAAc,GAAG;IACrB,GAAG,8BAAgB;IACnB,GAAG,kCAAkB;IACrB,GAAG,4BAAe;CACV,CAAC;AAEX,iEAAiE;AACjE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,iBAAM,CACvB;IACE,IAAI,EAAE,YAAY;IAClB,OAAO;CACR,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7D,IAAI;YACJ,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,OAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;SAC3C,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC,CAAC,CAAC;AAUH,MAAM,YAAY,GAAgC,EAAE,CAAC;AAErD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,8BAAgB,CAAC,EAAE,CAAC;IACjD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAE,KAAK,CAAC,MAAM,CAAC,IAAwB,CAAiB,CAAC,IAAI,CAAC,CAAC;AAC/F,CAAC;AACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,kCAAkB,CAAC,EAAE,CAAC;IACnD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAE,KAAK,CAAC,QAAQ,CAAC,IAA0B,CAAiB,CAAC,IAAI,CAAC,CAAC;AACnG,CAAC;AACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,4BAAe,CAAC,EAAE,CAAC;IAChD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAE,KAAK,CAAC,KAAK,CAAC,IAAuB,CAAiB,CAAC,IAAI,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,mBAAQ,CAAC,oBAAS,CAAC,cAAc,EAAE,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,MAAM,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;YACtD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACtD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/services/linear.service.d.ts

@@ -0,0 +1,12 @@
+import { LinearConfig } from "../common/types";
+export declare class LinearService {
+    private apiKey;
+    constructor(config: LinearConfig);
+    query<T>(graphqlQuery: string, variables?: Record<string, unknown>): Promise<T>;
+    listIssues(teamId?: string, status?: string, limit?: number): Promise<unknown>;
+    getIssue(issueId: string): Promise<unknown>;
+    searchIssues(searchQuery: string, limit?: number): Promise<unknown>;
+    listProjects(limit?: number): Promise<unknown>;
+    getProject(projectId: string): Promise<unknown>;
+    listTeams(limit?: number): Promise<unknown>;
+}

package/build/services/linear.service.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinearService = void 0;
+const GRAPHQL_ENDPOINT = "https://api.linear.app/graphql";
+// ===========================================================================
+// GraphQL query fragments
+// ===========================================================================
+const ISSUE_FIELDS = `
+  id
+  identifier
+  title
+  description
+  priority
+  state { name type }
+  assignee { name email }
+  team { name key }
+  labels { nodes { name } }
+  createdAt
+  updatedAt
+  url
+`;
+const PROJECT_FIELDS = `
+  id
+  name
+  description
+  state
+  progress
+  startDate
+  targetDate
+  teams { nodes { name } }
+  lead { name }
+  url
+`;
+const TEAM_FIELDS = `
+  id
+  name
+  key
+  description
+  members { nodes { name email } }
+`;
+// ===========================================================================
+// Service
+// ===========================================================================
+class LinearService {
+    apiKey;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+    }
+    async query(graphqlQuery, variables) {
+        const response = await fetch(GRAPHQL_ENDPOINT, {
+            method: "POST",
+            headers: {
+                Authorization: this.apiKey,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ query: graphqlQuery, variables }),
+        });
+        // Handle HTTP-level errors
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => "");
+            switch (response.status) {
+                case 401:
+                    throw new Error("Authentication failed. Check your LINEAR_API_KEY.");
+                case 429: {
+                    const retryAfter = response.headers.get("Retry-After") ?? "unknown";
+                    throw new Error(`Rate limited by Linear. Retry after ${retryAfter} seconds.`);
+                }
+                default:
+                    throw new Error(`Linear API error (${response.status}): ${errorBody || response.statusText}`);
+            }
+        }
+        const json = (await response.json());
+        // Handle GraphQL-level errors
+        if (json.errors && json.errors.length > 0) {
+            const messages = json.errors.map((e) => e.message).join("; ");
+            throw new Error(`Linear GraphQL error: ${messages}`);
+        }
+        if (!json.data) {
+            throw new Error("Linear API returned no data.");
+        }
+        return json.data;
+    }
+    // ===========================================================================
+    // Issues
+    // ===========================================================================
+    async listIssues(teamId, status, limit = 25) {
+        const filterParts = [];
+        if (teamId)
+            filterParts.push(`team: { id: { eq: "${teamId}" } }`);
+        if (status)
+            filterParts.push(`state: { name: { eqCaseInsensitive: "${status}" } }`);
+        const filterArg = filterParts.length > 0 ? `, filter: { ${filterParts.join(", ")} }` : "";
+        const graphqlQuery = `
+      query ListIssues {
+        issues(first: ${limit}${filterArg}) {
+          nodes { ${ISSUE_FIELDS} }
+        }
+      }
+    `;
+        const data = await this.query(graphqlQuery);
+        return data.issues;
+    }
+    async getIssue(issueId) {
+        const graphqlQuery = `
+      query GetIssue($id: String!) {
+        issue(id: $id) { ${ISSUE_FIELDS} }
+      }
+    `;
+        const data = await this.query(graphqlQuery, { id: issueId });
+        return data.issue;
+    }
+    async searchIssues(searchQuery, limit = 25) {
+        const graphqlQuery = `
+      query SearchIssues($query: String!, $first: Int) {
+        searchIssues(query: $query, first: $first) {
+          nodes { ${ISSUE_FIELDS} }
+        }
+      }
+    `;
+        const data = await this.query(graphqlQuery, {
+            query: searchQuery,
+            first: limit,
+        });
+        return data.searchIssues;
+    }
+    // ===========================================================================
+    // Projects
+    // ===========================================================================
+    async listProjects(limit = 25) {
+        const graphqlQuery = `
+      query ListProjects($first: Int) {
+        projects(first: $first) {
+          nodes { ${PROJECT_FIELDS} }
+        }
+      }
+    `;
+        const data = await this.query(graphqlQuery, { first: limit });
+        return data.projects;
+    }
+    async getProject(projectId) {
+        const graphqlQuery = `
+      query GetProject($id: String!) {
+        project(id: $id) { ${PROJECT_FIELDS} }
+      }
+    `;
+        const data = await this.query(graphqlQuery, { id: projectId });
+        return data.project;
+    }
+    // ===========================================================================
+    // Teams
+    // ===========================================================================
+    async listTeams(limit = 25) {
+        const graphqlQuery = `
+      query ListTeams($first: Int) {
+        teams(first: $first) {
+          nodes { ${TEAM_FIELDS} }
+        }
+      }
+    `;
+        const data = await this.query(graphqlQuery, { first: limit });
+        return data.teams;
+    }
+}
+exports.LinearService = LinearService;
+//# sourceMappingURL=linear.service.js.map

package/build/services/linear.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.service.js","sourceRoot":"","sources":["../../src/services/linear.service.ts"],"names":[],"mappings":"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"}

package/build/tools/issue.tools.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { LinearService } from "../services/linear.service";
+export declare const IssueToolSchemas: {
+    list_issues: {
+        description: string;
+        schema: z.ZodObject<{
+            team_id: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+    get_issue: {
+        description: string;
+        schema: z.ZodObject<{
+            issue_id: z.ZodString;
+        }, z.core.$strip>;
+    };
+    search_issues: {
+        description: string;
+        schema: z.ZodObject<{
+            query: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class IssueTools {
+    private linearService;
+    constructor(linearService: LinearService);
+    list_issues(args: z.infer<typeof IssueToolSchemas.list_issues.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_issue(args: z.infer<typeof IssueToolSchemas.get_issue.schema>): Promise<import("../common/types").McpToolResponse>;
+    search_issues(args: z.infer<typeof IssueToolSchemas.search_issues.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/issue.tools.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IssueTools = exports.IssueToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.IssueToolSchemas = {
+    list_issues: {
+        description: "Lists issues from Linear, optionally filtered by team and status. Returns issue title, identifier, priority, state, assignee, and labels.",
+        schema: zod_1.z.object({
+            team_id: zod_1.z.string().optional().describe("Team ID to filter issues by."),
+            status: zod_1.z
+                .string()
+                .optional()
+                .describe("Workflow state name to filter by (e.g., 'In Progress', 'Done')."),
+            limit: zod_1.z.number().optional().default(25).describe("Number of issues to return (max 50)."),
+        }),
+    },
+    get_issue: {
+        description: "Retrieves full details for a specific Linear issue including title, description, state, priority, assignee, labels, and timestamps. Accepts both UUID and human-readable identifier (e.g., 'ENG-123').",
+        schema: zod_1.z.object({
+            issue_id: zod_1.z.string().describe("The issue ID (UUID) or identifier (e.g., 'ENG-123')."),
+        }),
+    },
+    search_issues: {
+        description: "Searches Linear issues by text query across all teams. Returns matching issues with title, identifier, priority, state, and assignee.",
+        schema: zod_1.z.object({
+            query: zod_1.z.string().describe("Search query to find issues by title or description."),
+            limit: zod_1.z.number().optional().default(25).describe("Number of issues to return (max 50)."),
+        }),
+    },
+};
+class IssueTools {
+    linearService;
+    constructor(linearService) {
+        this.linearService = linearService;
+    }
+    async list_issues(args) {
+        const issues = await this.linearService.listIssues(args.team_id, args.status, args.limit);
+        return (0, utils_1.formatMcpResponse)(issues);
+    }
+    async get_issue(args) {
+        const issue = await this.linearService.getIssue(args.issue_id);
+        return (0, utils_1.formatMcpResponse)(issue);
+    }
+    async search_issues(args) {
+        const issues = await this.linearService.searchIssues(args.query, args.limit);
+        return (0, utils_1.formatMcpResponse)(issues);
+    }
+}
+exports.IssueTools = IssueTools;
+//# sourceMappingURL=issue.tools.js.map

package/build/tools/issue.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.tools.js","sourceRoot":"","sources":["../../src/tools/issue.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,gBAAgB,GAAG;IAC9B,WAAW,EAAE;QACX,WAAW,EACT,2IAA2I;QAC7I,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YACvE,MAAM,EAAE,OAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SAC1F,CAAC;KACH;IACD,SAAS,EAAE;QACT,WAAW,EACT,wMAAwM;QAC1M,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;SACtF,CAAC;KACH;IACD,aAAa,EAAE;QACb,WAAW,EACT,uIAAuI;QACzI,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;YAClF,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SAC1F,CAAC;KACH;CACF,CAAC;AAEF,MAAa,UAAU;IACD;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,WAAW,CAAC,IAAyD;QACzE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1F,OAAO,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAuD;QACrE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/D,OAAO,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAA2D;QAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7E,OAAO,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF;AAjBD,gCAiBC"}

package/build/tools/project.tools.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { LinearService } from "../services/linear.service";
+export declare const ProjectToolSchemas: {
+    list_projects: {
+        description: string;
+        schema: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+    get_project: {
+        description: string;
+        schema: z.ZodObject<{
+            project_id: z.ZodString;
+        }, z.core.$strip>;
+    };
+};
+export declare class ProjectTools {
+    private linearService;
+    constructor(linearService: LinearService);
+    list_projects(args: z.infer<typeof ProjectToolSchemas.list_projects.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_project(args: z.infer<typeof ProjectToolSchemas.get_project.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/project.tools.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectTools = exports.ProjectToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.ProjectToolSchemas = {
+    list_projects: {
+        description: "Lists all projects in the Linear workspace. Returns project name, state, progress percentage, lead, start/target dates, and associated teams.",
+        schema: zod_1.z.object({
+            limit: zod_1.z.number().optional().default(25).describe("Number of projects to return (max 50)."),
+        }),
+    },
+    get_project: {
+        description: "Retrieves full details for a specific Linear project including name, description, state, progress, lead, start/target dates, and associated teams.",
+        schema: zod_1.z.object({
+            project_id: zod_1.z.string().describe("The project ID (UUID)."),
+        }),
+    },
+};
+class ProjectTools {
+    linearService;
+    constructor(linearService) {
+        this.linearService = linearService;
+    }
+    async list_projects(args) {
+        const projects = await this.linearService.listProjects(args.limit);
+        return (0, utils_1.formatMcpResponse)(projects);
+    }
+    async get_project(args) {
+        const project = await this.linearService.getProject(args.project_id);
+        return (0, utils_1.formatMcpResponse)(project);
+    }
+}
+exports.ProjectTools = ProjectTools;
+//# sourceMappingURL=project.tools.js.map

package/build/tools/project.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.tools.js","sourceRoot":"","sources":["../../src/tools/project.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,kBAAkB,GAAG;IAChC,aAAa,EAAE;QACb,WAAW,EACT,+IAA+I;QACjJ,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SAC5F,CAAC;KACH;IACD,WAAW,EAAE;QACX,WAAW,EACT,oJAAoJ;QACtJ,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC1D,CAAC;KACH;CACF,CAAC;AAEF,MAAa,YAAY;IACH;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,aAAa,CAAC,IAA6D;QAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,IAAA,yBAAiB,EAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAA2D;QAC3E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,OAAO,IAAA,yBAAiB,EAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF;AAZD,oCAYC"}

package/build/tools/team.tools.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { LinearService } from "../services/linear.service";
+export declare const TeamToolSchemas: {
+    list_teams: {
+        description: string;
+        schema: z.ZodObject<{
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class TeamTools {
+    private linearService;
+    constructor(linearService: LinearService);
+    list_teams(args: z.infer<typeof TeamToolSchemas.list_teams.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/team.tools.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamTools = exports.TeamToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.TeamToolSchemas = {
+    list_teams: {
+        description: "Lists all teams in the Linear workspace including name, key (prefix for issue identifiers), description, and members.",
+        schema: zod_1.z.object({
+            limit: zod_1.z.number().optional().default(25).describe("Number of teams to return (max 50)."),
+        }),
+    },
+};
+class TeamTools {
+    linearService;
+    constructor(linearService) {
+        this.linearService = linearService;
+    }
+    async list_teams(args) {
+        const teams = await this.linearService.listTeams(args.limit);
+        return (0, utils_1.formatMcpResponse)(teams);
+    }
+}
+exports.TeamTools = TeamTools;
+//# sourceMappingURL=team.tools.js.map

package/build/tools/team.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.tools.js","sourceRoot":"","sources":["../../src/tools/team.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,eAAe,GAAG;IAC7B,UAAU,EAAE;QACV,WAAW,EACT,uHAAuH;QACzH,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;SACzF,CAAC;KACH;CACF,CAAC;AAEF,MAAa,SAAS;IACA;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,UAAU,CAAC,IAAuD;QACtE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7D,OAAO,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AAPD,8BAOC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@vineethnkrishnan/linear-mcp",
+  "version": "0.1.1",
+  "description": "A read-only MCP server for Linear API, enabling AI assistants to query issues, projects, and teams via GraphQL.",
+  "main": "build/index.js",
+  "bin": {
+    "linear-mcp": "build/index.js"
+  },
+  "files": [
+    "build/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "test": "jest --coverage"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "linear",
+    "ai",
+    "model-context-protocol",
+    "project-management",
+    "graphql"
+  ],
+  "author": "Vineeth Krishnan",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.5.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.7.0"
+  }
+}