dueey-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gregory Murphy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# Dueey MCP Server
+
+MCP server for the [Dueey](https://dueey.com) PM Assistant public API.  
+Exposes boards, lists, cards, and exports as MCP tools for Claude and other AI clients.
+
+## Setup
+
+### Option A: Install from npm
+
+```bash
+npm install -g dueey-mcp
+# or use with npx: npx dueey-mcp
+```
+
+### Option B: Install from source
+
+```bash
+npm install
+npm run build
+```
+
+### 2. Get your API key
+
+In Dueey: **Settings → API Access** → generate a token (starts with `pm_...`).
+
+### 3. Add to your AI client
+
+#### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or  
+`%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "dueey": {
+      "command": "node",
+      "args": ["/path/to/dueey-mcp/dist/index.js"],
+      "env": {
+        "DUEEY_API_KEY": "pm_your_token_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop.
+
+#### Cursor
+
+Add the server in **Cursor Settings → Features → MCP** (or your project’s `.cursor/mcp.json`). Example:
+
+```json
+{
+  "mcpServers": {
+    "dueey": {
+      "command": "node",
+      "args": ["/path/to/dueey-mcp/dist/index.js"],
+      "env": {
+        "DUEEY_API_KEY": "pm_your_token_here"
+      }
+    }
+  }
+}
+```
+
+If you installed globally (`npm install -g dueey-mcp`), use the path from `npm root -g` (e.g. `"args": ["/usr/local/lib/node_modules/dueey-mcp/dist/index.js"]`) or use `npx`: `"command": "npx", "args": ["dueey-mcp"]` and keep `env` as above.
+
+#### Other clients
+
+Any client that supports MCP over stdio (e.g. Windsurf, Continue, custom setups) can use this server: run `node /path/to/dist/index.js` with `DUEEY_API_KEY` set in the environment and point the client at that process.
+
+---
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_me` | Current authenticated user |
+| `list_boards` | All boards (optional `workspaceId` filter) |
+| `get_board` | Single board by ID or slug |
+| `list_lists` | Lists/columns for a board |
+| `list_cards` | Cards filtered by board or list |
+| `get_card` | Single card by UUID or cardKey (e.g. `SWAT-42`) |
+| `create_card` | Create a card with title, description, priority, labels, dates, checklist |
+| `update_card` | Update any card field; use `listId` to move a card |
+| `get_data` | Full export — all workspaces, boards, lists, cards |
+
+---
+
+## Example prompts
+
+- *"Show me all my Dueey boards"*
+- *"List the cards in my Roadmap board"*
+- *"Create a high-priority card called 'Fix login bug' in my Backlog list"*
+- *"Move card SWAT-12 to the Done column"*
+- *"Export all my data from Dueey"*

package/dist/index.js

@@ -0,0 +1,231 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+const BASE_URL = "https://dueey.com/api/v1";
+const API_KEY = process.env.DUEEY_API_KEY ?? "";
+if (!API_KEY) {
+    console.error("Error: DUEEY_API_KEY environment variable is required.");
+    process.exit(1);
+}
+async function dueeyFetch(path, options = {}) {
+    const { params, ...fetchOptions } = options;
+    const url = new URL(`${BASE_URL}${path}`);
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    const res = await fetch(url.toString(), {
+        ...fetchOptions,
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+            ...(fetchOptions.headers ?? {}),
+        },
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new McpError(ErrorCode.InternalError, `Dueey API error ${res.status}: ${text || res.statusText}`);
+    }
+    return res.json();
+}
+const server = new Server({ name: "dueey-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
+// ─── Tool Definitions ────────────────────────────────────────────────────────
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        // User
+        {
+            name: "get_me",
+            description: "Get the currently authenticated Dueey user (id, email, name).",
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        // Boards
+        {
+            name: "list_boards",
+            description: "List all boards the user has access to, optionally filtered by workspace.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    workspaceId: { type: "string", description: "Filter by workspace ID" },
+                    fields: { type: "string", description: "Comma-separated fields to return" },
+                },
+            },
+        },
+        {
+            name: "get_board",
+            description: "Get full details for a single board by its ID or slug.",
+            inputSchema: {
+                type: "object",
+                required: ["id"],
+                properties: {
+                    id: { type: "string", description: "Board ID or slug" },
+                    fields: { type: "string" },
+                },
+            },
+        },
+        // Lists
+        {
+            name: "list_lists",
+            description: "Get all lists (columns) for a specific board.",
+            inputSchema: {
+                type: "object",
+                required: ["boardId"],
+                properties: {
+                    boardId: { type: "string", description: "Board ID" },
+                    fields: { type: "string" },
+                },
+            },
+        },
+        // Cards
+        {
+            name: "list_cards",
+            description: "List cards, optionally filtered by board or list. Returns up to `limit` cards (default 50).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    boardId: { type: "string" },
+                    listId: { type: "string" },
+                    limit: { type: "number", description: "Max results (default 50)" },
+                    fields: { type: "string" },
+                },
+            },
+        },
+        {
+            name: "get_card",
+            description: "Get a single card by its UUID or cardKey (e.g. SWAT-42).",
+            inputSchema: {
+                type: "object",
+                required: ["id"],
+                properties: {
+                    id: { type: "string", description: "Card UUID or cardKey" },
+                    fields: { type: "string" },
+                },
+            },
+        },
+        {
+            name: "create_card",
+            description: "Create a new card in a list.",
+            inputSchema: {
+                type: "object",
+                required: ["listId", "title"],
+                properties: {
+                    listId: { type: "string" },
+                    title: { type: "string" },
+                    description: { type: "string" },
+                    priority: {
+                        type: "string",
+                        enum: ["critical", "high", "medium", "low", "none"],
+                    },
+                    labels: { type: "array", items: { type: "string" } },
+                    dueDate: { type: "string", description: "ISO date e.g. 2025-12-31" },
+                    startDate: { type: "string" },
+                    checklist: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                text: { type: "string" },
+                                completed: { type: "boolean" },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        {
+            name: "update_card",
+            description: "Update an existing card. Pass only the fields you want to change. Use `listId` to move a card to another list.",
+            inputSchema: {
+                type: "object",
+                required: ["id"],
+                properties: {
+                    id: { type: "string", description: "Card UUID or cardKey" },
+                    title: { type: "string" },
+                    description: { type: "string" },
+                    priority: {
+                        type: "string",
+                        enum: ["critical", "high", "medium", "low", "none"],
+                    },
+                    labels: { type: "array", items: { type: "string" } },
+                    dueDate: { type: "string", nullable: true },
+                    startDate: { type: "string", nullable: true },
+                    checklist: { type: "array" },
+                    listId: { type: "string", description: "Move card to this list" },
+                },
+            },
+        },
+        // Export
+        {
+            name: "get_data",
+            description: "Full export of all workspaces, boards, lists, and cards keyed by ID. Use `compact=true` to omit nulls and heavy fields.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    compact: { type: "boolean" },
+                },
+            },
+        },
+    ],
+}));
+// ─── Tool Handlers ───────────────────────────────────────────────────────────
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    const ok = (data) => ({
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    });
+    switch (name) {
+        case "get_me":
+            return ok(await dueeyFetch("/me"));
+        case "list_boards":
+            return ok(await dueeyFetch("/boards", {
+                params: { workspaceId: args.workspaceId, fields: args.fields },
+            }));
+        case "get_board":
+            return ok(await dueeyFetch(`/boards/${args.id}`, {
+                params: { fields: args.fields },
+            }));
+        case "list_lists":
+            return ok(await dueeyFetch("/lists", {
+                params: { boardId: args.boardId, fields: args.fields },
+            }));
+        case "list_cards":
+            return ok(await dueeyFetch("/cards", {
+                params: {
+                    boardId: args.boardId,
+                    listId: args.listId,
+                    limit: args.limit,
+                    fields: args.fields,
+                },
+            }));
+        case "get_card":
+            return ok(await dueeyFetch(`/cards/${args.id}`, {
+                params: { fields: args.fields },
+            }));
+        case "create_card": {
+            const { ...body } = args;
+            return ok(await dueeyFetch("/cards", {
+                method: "POST",
+                body: JSON.stringify(body),
+            }));
+        }
+        case "update_card": {
+            const { id, ...body } = args;
+            return ok(await dueeyFetch(`/cards/${id}`, {
+                method: "PATCH",
+                body: JSON.stringify(body),
+            }));
+        }
+        case "get_data":
+            return ok(await dueeyFetch("/data", {
+                params: { compact: args.compact ? "1" : undefined },
+            }));
+        default:
+            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+});
+// ─── Start ───────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+server.connect(transport);
+console.error("Dueey MCP server running.");

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "dueey-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for the Dueey PM Assistant public API",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": { "dueey-mcp": "dist/index.js" },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node --esm src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": ["dist", "README.md"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gmurph91/dueeymcp.git"
+  },
+  "keywords": ["mcp", "dueey", "model-context-protocol", "claude", "pm", "project-management"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}