@addai/tasks-mcp 1.0.0

package/README.md

@@ -0,0 +1,43 @@
+# @addai/tasks-mcp
+
+MCP server for **+Ai Tasks** — create, list, complete, update, and delete tasks
+from any MCP-capable AI assistant (Claude Desktop, Claude Code, entities, etc.).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_task` | Create a task (title, description, assignee, due date, priority, reminders, optional AiTables write-back link). |
+| `list_tasks` | List tasks in the key's workspace, filterable by assignee / status / limit. |
+| `get_task` | Fetch one task by id. |
+| `complete_task` | Mark a task completed (triggers any AiTables write-back). |
+| `update_task` | Patch title / description / due date / priority / assignee / status. |
+| `delete_task` | Delete a task. |
+
+## Auth
+
+The server talks to the `tasks-api` edge function at
+`https://syhzpqqvrplaqdipcymw.supabase.co/functions/v1/tasks-api`.
+
+Every request carries `Authorization: Bearer <ADDAI_API_KEY>`, where the key is a
+**workspace API key** (starts `ait_`). The edge function resolves the workspace
+(and, if the key is bound to an entity, that entity's profile) from the key alone
+— no `workspace_id` is ever passed in the body.
+
+Provide the key via:
+
+- `ADDAI_API_KEY` env var (CI / explicit), or
+- the OAuth browser flow (`npx -y @addai/tasks-mcp login`).
+
+## Install
+
+```bash
+npx -y @addai/tasks-mcp install
+```
+
+## Build from source
+
+```bash
+npm install
+npm run build   # tsc -> dist/
+```

package/dist/bin/install.d.ts

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

package/dist/bin/install.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import * as readline from "node:readline";
+// Service endpoint is baked in at install time and at runtime — only used here
+// for the API-key validation probe during install.
+const DEFAULT_API_URL = "https://syhzpqqvrplaqdipcymw.supabase.co/functions/v1/tasks-api";
+// --- Helpers ---
+function prompt(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+function print(msg) {
+    process.stdout.write(msg + "\n");
+}
+const c = (code, text) => `\x1b[38;5;${code}m${text}\x1b[0m`;
+const bold = (text) => `\x1b[1m${text}\x1b[0m`;
+function printLogo() {
+    print("");
+    print(`    ${bold(c(51, "+Ai"))}  ${bold(c(135, "Tasks"))}  ${c(245, "MCP Server")}`);
+    print(`    ${c(240, "───────────────────────")}`);
+    print("");
+}
+function printError(msg) {
+    process.stderr.write(`Error: ${msg}\n`);
+}
+function expandHome(p) {
+    if (p.startsWith("~")) {
+        return path.join(os.homedir(), p.slice(1));
+    }
+    return p;
+}
+// --- Config detection ---
+function getConfigLocations() {
+    const platform = os.platform();
+    const locations = [];
+    // Claude Desktop
+    let desktopPath;
+    if (platform === "darwin") {
+        desktopPath = expandHome("~/Library/Application Support/Claude/claude_desktop_config.json");
+    }
+    else if (platform === "win32") {
+        desktopPath = path.join(process.env.APPDATA || "", "Claude", "claude_desktop_config.json");
+    }
+    else {
+        desktopPath = expandHome("~/.config/Claude/claude_desktop_config.json");
+    }
+    if (fs.existsSync(desktopPath)) {
+        locations.push({
+            name: "Claude Desktop",
+            path: desktopPath,
+            key: "mcpServers",
+        });
+    }
+    // Claude Code (global) - uses ~/.claude.json top-level mcpServers
+    const codePath = expandHome("~/.claude.json");
+    if (fs.existsSync(codePath)) {
+        locations.push({
+            name: "Claude Code (global)",
+            path: codePath,
+            key: "mcpServers",
+        });
+    }
+    // Claude Code (project-level - current directory)
+    const projectSettingsDir = path.join(process.cwd(), ".claude");
+    if (fs.existsSync(projectSettingsDir)) {
+        const projectPath = path.join(projectSettingsDir, "settings.local.json");
+        locations.push({
+            name: "Claude Code (this project)",
+            path: projectPath,
+            key: "mcpServers",
+        });
+    }
+    return locations;
+}
+// --- API key validation ---
+async function validateApiKey(apiKey, apiUrl) {
+    try {
+        // Hit an authenticated endpoint - 401 means invalid key, anything else means
+        // the key was accepted (valid workspace key).
+        const url = `${apiUrl.replace(/\/+$/, "")}/tasks?limit=1`;
+        const res = await fetch(url, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        return res.status !== 401;
+    }
+    catch {
+        return false;
+    }
+}
+// --- Config read/write ---
+function readJsonFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return {};
+        }
+        throw new Error(`Failed to read ${filePath}: ${err.message}`);
+    }
+}
+function writeJsonFile(filePath, data) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+function updateConfig(configPath, serverKey, apiKey) {
+    const config = readJsonFile(configPath);
+    if (!config[serverKey]) {
+        config[serverKey] = {};
+    }
+    // Claude Code (.claude.json) needs type: 'stdio', Desktop doesn't
+    const isClaudeCode = configPath.endsWith(".claude.json");
+    // OAuth path: omit ADDAI_API_KEY entirely — the package reads cached
+    // tokens from ~/.addai/tasks-mcp/ on startup.
+    // API-key path: include ADDAI_API_KEY so the package skips OAuth.
+    const env = {};
+    if (apiKey)
+        env.ADDAI_API_KEY = apiKey;
+    config[serverKey]["addai-tasks"] = {
+        ...(isClaudeCode ? { type: "stdio" } : {}),
+        command: "npx",
+        args: ["-y", "@addai/tasks-mcp@latest"],
+        env,
+    };
+    writeJsonFile(configPath, config);
+}
+// --- Main ---
+async function main() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    printLogo();
+    try {
+        // 1. Choose auth method
+        print(`  ${c(46, "1)")} ${bold("Authenticate with +Ai")} (recommended) — opens your browser, no key handling`);
+        print(`  ${c(46, "2)")} ${bold("Use an API key")} — paste a workspace key (starts ait_)`);
+        print("");
+        let apiKey = "";
+        const choice = (await prompt(rl, "Pick auth method [1/2]: ")).trim();
+        const apiUrl = DEFAULT_API_URL;
+        if (choice === "2") {
+            // ── API key path ────────────────────────────────────────────────
+            print("");
+            while (true) {
+                apiKey = await prompt(rl, "Enter your +Ai API key (starts with ait_): ");
+                if (!apiKey) {
+                    printError("API key is required.");
+                    continue;
+                }
+                if (!apiKey.startsWith("ait_")) {
+                    printError("API key must start with 'ait_'.");
+                    continue;
+                }
+                break;
+            }
+            print("");
+            print("Validating API key...");
+            const valid = await validateApiKey(apiKey, apiUrl);
+            if (!valid) {
+                printError("Could not validate API key. Check that the key is correct.");
+                const continueAnyway = await prompt(rl, "Continue anyway? (y/N): ");
+                if (continueAnyway.toLowerCase() !== "y") {
+                    print("Installation cancelled.");
+                    rl.close();
+                    process.exit(1);
+                }
+            }
+            else {
+                print("API key validated successfully.");
+            }
+        }
+        else {
+            // ── OAuth path ──────────────────────────────────────────────────
+            print("");
+            print("Opening your browser to authenticate with +Ai...");
+            try {
+                const { getOAuthAccessToken } = await import("../oauth.js");
+                await getOAuthAccessToken({ interactive: true });
+                print(`  ${c(46, "✓")} Signed in. Cached at ~/.addai/tasks-mcp/`);
+                // We do NOT store the token in the MCP config — the runtime reads it
+                // from the cache. apiKey stays empty so the env block omits ADDAI_API_KEY.
+            }
+            catch (err) {
+                printError(`Sign-in failed: ${err?.message || err}`);
+                const fallback = await prompt(rl, "Switch to API key instead? (Y/n): ");
+                if (fallback.toLowerCase() === "n") {
+                    print("Installation cancelled.");
+                    rl.close();
+                    process.exit(1);
+                }
+                while (true) {
+                    apiKey = await prompt(rl, "Enter your +Ai API key (starts with ait_): ");
+                    if (apiKey.startsWith("ait_"))
+                        break;
+                    printError("API key must start with 'ait_'.");
+                }
+            }
+        }
+        // 2. Detect config locations
+        print("");
+        const locations = getConfigLocations();
+        if (locations.length === 0) {
+            print("No Claude configuration files found.");
+            print("Expected locations:");
+            print("  - Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json");
+            print("  - Claude Code: ~/.claude.json");
+            print("");
+            const createNew = await prompt(rl, "Would you like to create a Claude Desktop config? (y/N): ");
+            if (createNew.toLowerCase() !== "y") {
+                print("Installation cancelled.");
+                rl.close();
+                process.exit(1);
+            }
+            const platform = os.platform();
+            let desktopPath;
+            if (platform === "darwin") {
+                desktopPath = expandHome("~/Library/Application Support/Claude/claude_desktop_config.json");
+            }
+            else if (platform === "win32") {
+                desktopPath = path.join(process.env.APPDATA || "", "Claude", "claude_desktop_config.json");
+            }
+            else {
+                desktopPath = expandHome("~/.config/Claude/claude_desktop_config.json");
+            }
+            locations.push({
+                name: "Claude Desktop (new)",
+                path: desktopPath,
+                key: "mcpServers",
+            });
+        }
+        // 3. Select config to update
+        let selectedLocation;
+        if (locations.length === 1) {
+            const confirm = await prompt(rl, `Update ${locations[0].name} config at ${locations[0].path}? (Y/n): `);
+            if (confirm.toLowerCase() === "n") {
+                print("Installation cancelled.");
+                rl.close();
+                process.exit(1);
+            }
+            selectedLocation = locations[0];
+        }
+        else {
+            print("Found multiple Claude configurations:");
+            locations.forEach((loc, i) => {
+                print(`  ${i + 1}. ${loc.name} (${loc.path})`);
+            });
+            print(`  ${locations.length + 1}. All of the above`);
+            print("");
+            const sel = await prompt(rl, `Select config to update (1-${locations.length + 1}): `);
+            const index = parseInt(sel, 10);
+            if (index === locations.length + 1) {
+                for (const loc of locations) {
+                    print(`Updating ${loc.name}...`);
+                    updateConfig(loc.path, loc.key, apiKey);
+                    print(`  Updated: ${loc.path}`);
+                }
+                print("");
+                print("All configurations updated successfully!");
+                print("");
+                print(`  ${c(46, "✓")} Setup complete. The +Ai Tasks MCP server is ready to use.`);
+                print(`  ${c(245, "Restart Claude to load the MCP server.")}`);
+                rl.close();
+                return;
+            }
+            if (isNaN(index) || index < 1 || index > locations.length) {
+                printError("Invalid selection.");
+                rl.close();
+                process.exit(1);
+            }
+            selectedLocation = locations[index - 1];
+        }
+        // 4. Update the config
+        print("");
+        print(`Updating ${selectedLocation.name} config...`);
+        updateConfig(selectedLocation.path, selectedLocation.key, apiKey);
+        print(`Updated: ${selectedLocation.path}`);
+        // 5. Done
+        print("");
+        print(`  ${c(46, "✓")} Setup complete. The +Ai Tasks MCP server is ready to use.`);
+        if (selectedLocation.name.includes("Code")) {
+            print(`  ${c(245, "Restart Claude Code to load the MCP server.")}`);
+        }
+        else {
+            print(`  ${c(245, "Restart Claude Desktop to load the MCP server.")}`);
+        }
+        rl.close();
+    }
+    catch (err) {
+        printError(err.message || String(err));
+        rl.close();
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=install.js.map

package/dist/bin/install.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,59 @@
+/**
+ * HTTP client for the +Ai Tasks API edge function.
+ *
+ * Auth: every request carries `Authorization: Bearer <apiKey>` where apiKey is a
+ * workspace API key (starts `ait_`). The edge function resolves workspace_id (and,
+ * if the key is bound to an entity, that entity + its user_profile) FROM THE KEY
+ * ALONE — callers never pass workspace_id in the body.
+ */
+export interface ReminderInput {
+    offset_value: number;
+    offset_unit: 'minutes' | 'hours' | 'days';
+    label?: string;
+}
+export interface TaskLinkInput {
+    database_id: string;
+    table_id: string;
+    record_id?: string;
+    record_filters?: unknown;
+    status_column_id: string;
+    status_column_type: 'select' | 'boolean';
+    complete_value?: unknown;
+    pending_value?: unknown;
+    revert_on_reopen?: boolean;
+}
+export interface CreateTaskInput {
+    title: string;
+    description?: string;
+    assigned_to?: string;
+    due_date?: string;
+    priority?: 'low' | 'medium' | 'high' | 'urgent';
+    conversation_id?: string;
+    reminders?: ReminderInput[];
+    link?: TaskLinkInput;
+}
+export interface ListTasksQuery {
+    assigned_to?: string;
+    status?: 'pending' | 'completed';
+    limit?: number;
+}
+export interface UpdateTaskInput {
+    title?: string;
+    description?: string;
+    due_date?: string;
+    priority?: 'low' | 'medium' | 'high' | 'urgent';
+    assigned_to?: string;
+    status?: 'pending' | 'completed';
+}
+export declare class TasksApiClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    private request;
+    createTask(body: CreateTaskInput): Promise<unknown>;
+    listTasks(query?: ListTasksQuery): Promise<unknown>;
+    getTask(id: string): Promise<unknown>;
+    completeTask(id: string): Promise<unknown>;
+    updateTask(id: string, body: UpdateTaskInput): Promise<unknown>;
+    deleteTask(id: string): Promise<unknown>;
+}

package/dist/client.js

@@ -0,0 +1,76 @@
+/**
+ * HTTP client for the +Ai Tasks API edge function.
+ *
+ * Auth: every request carries `Authorization: Bearer <apiKey>` where apiKey is a
+ * workspace API key (starts `ait_`). The edge function resolves workspace_id (and,
+ * if the key is bound to an entity, that entity + its user_profile) FROM THE KEY
+ * ALONE — callers never pass workspace_id in the body.
+ */
+const DEFAULT_BASE_URL = 'https://syhzpqqvrplaqdipcymw.supabase.co/functions/v1/tasks-api';
+function extractErrorMessage(body, status) {
+    if (body && typeof body === 'object') {
+        const err = body.error;
+        if (typeof err === 'string')
+            return err;
+        if (err && typeof err === 'object') {
+            return err.message || err.code || JSON.stringify(err);
+        }
+        if (body.message)
+            return body.message;
+    }
+    return `HTTP ${status}`;
+}
+export class TasksApiClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = DEFAULT_BASE_URL) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+    }
+    async request(method, path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const errBody = await res.json().catch(() => null);
+            throw new Error(extractErrorMessage(errBody, res.status));
+        }
+        // 204 / empty body tolerance
+        const text = await res.text();
+        if (!text)
+            return {};
+        return JSON.parse(text);
+    }
+    createTask(body) {
+        return this.request('POST', '/tasks', body);
+    }
+    listTasks(query = {}) {
+        const params = new URLSearchParams();
+        if (query.assigned_to)
+            params.set('assigned_to', query.assigned_to);
+        if (query.status)
+            params.set('status', query.status);
+        if (query.limit !== undefined)
+            params.set('limit', String(query.limit));
+        const qs = params.toString();
+        return this.request('GET', `/tasks${qs ? `?${qs}` : ''}`);
+    }
+    getTask(id) {
+        return this.request('GET', `/tasks/${encodeURIComponent(id)}`);
+    }
+    completeTask(id) {
+        return this.request('POST', `/tasks/${encodeURIComponent(id)}/complete`);
+    }
+    updateTask(id, body) {
+        return this.request('PATCH', `/tasks/${encodeURIComponent(id)}`, body);
+    }
+    deleteTask(id) {
+        return this.request('DELETE', `/tasks/${encodeURIComponent(id)}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+// Subcommands:
+//   install — interactive installer
+//   login   — force a fresh OAuth browser flow (replaces cached tokens)
+//   logout  — clear cached OAuth tokens + client info
+const subcommand = process.argv[2];
+if (subcommand === 'install') {
+    await import('./bin/install.js');
+}
+else if (subcommand === 'login') {
+    const { getOAuthAccessToken, clearOAuthCache } = await import('./oauth.js');
+    await clearOAuthCache();
+    try {
+        await getOAuthAccessToken({ interactive: true });
+        console.log('[tasks-mcp] signed in. Tokens cached at ~/.addai/tasks-mcp/');
+    }
+    catch (err) {
+        console.error('[tasks-mcp] sign-in failed:', err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+}
+else if (subcommand === 'logout') {
+    const { clearOAuthCache } = await import('./oauth.js');
+    await clearOAuthCache();
+    console.log('[tasks-mcp] cleared cached OAuth credentials at ~/.addai/tasks-mcp/');
+}
+else {
+    const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const { TasksApiClient } = await import('./client.js');
+    const { registerTaskTools } = await import('./tools/tasks.js');
+    // Service endpoint is baked in. Users only configure ADDAI_API_KEY
+    // (legacy / CI) — OAuth is the default for interactive sessions.
+    const API_URL = 'https://syhzpqqvrplaqdipcymw.supabase.co/functions/v1/tasks-api';
+    // 1) ADDAI_API_KEY env — explicit override / CI path (a workspace key starting "ait_").
+    // 2) Cached OAuth tokens — silent path for returning users.
+    // 3) Full OAuth browser flow — first run.
+    let apiKey = process.env.ADDAI_API_KEY;
+    if (!apiKey) {
+        try {
+            const { getOAuthAccessToken } = await import('./oauth.js');
+            const session = await getOAuthAccessToken();
+            apiKey = session.accessToken;
+        }
+        catch (err) {
+            console.error('Authentication failed:', err instanceof Error ? err.message : err);
+            console.error('Either:');
+            console.error('  1) Set ADDAI_API_KEY in your env (a workspace key starting "ait_"), or');
+            console.error('  2) Run `npx -y @addai/tasks-mcp login` to authenticate via browser.');
+            process.exit(1);
+        }
+    }
+    const client = new TasksApiClient(apiKey, API_URL);
+    const server = new McpServer({ name: 'addai-tasks', version: '1.0.0' });
+    registerTaskTools(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/oauth.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MCP OAuth 2.1 client using loopback PKCE.
+ *
+ * Flow:
+ *   1. Read cached client + tokens from ~/.addai/flows-mcp/.
+ *   2. If access token is fresh → return it.
+ *   3. If access token expired but refresh token valid → call /token with grant_type=refresh_token.
+ *   4. Otherwise → full auth code flow:
+ *      a. (One-time) Register a client via /register if no client info cached.
+ *      b. Generate PKCE verifier + challenge.
+ *      c. Open a one-shot loopback HTTP server on a random port.
+ *      d. Open the system browser at /authorize.
+ *      e. User signs in via auth.add.ai, picks workspace, approves.
+ *      f. Auth server 302s to http://127.0.0.1:<port>/callback?code=…
+ *      g. Loopback handler captures the code, exchanges it at /token.
+ *      h. Tokens cached; loopback server shut down.
+ *
+ * The flow is silent and non-interactive when tokens are cached and valid —
+ * only the first run and the refresh-failure path pop a browser.
+ */
+export interface OAuthSession {
+    accessToken: string;
+    expiresAt: number;
+    scope: string;
+}
+/**
+ * Returns a valid access token, performing whichever flow is needed:
+ *   - cached and fresh                          → return as-is
+ *   - cached, expired, refresh valid            → refresh, return
+ *   - cached client only, no tokens / refresh   → full browser flow
+ *   - nothing cached                            → register + full browser flow
+ */
+export declare function getOAuthAccessToken(opts?: {
+    interactive?: boolean;
+}): Promise<OAuthSession>;
+/** Drop cached credentials. Useful for `flows-mcp logout`. */
+export declare function clearOAuthCache(): Promise<void>;

package/dist/oauth.js

@@ -0,0 +1,322 @@
+/**
+ * MCP OAuth 2.1 client using loopback PKCE.
+ *
+ * Flow:
+ *   1. Read cached client + tokens from ~/.addai/flows-mcp/.
+ *   2. If access token is fresh → return it.
+ *   3. If access token expired but refresh token valid → call /token with grant_type=refresh_token.
+ *   4. Otherwise → full auth code flow:
+ *      a. (One-time) Register a client via /register if no client info cached.
+ *      b. Generate PKCE verifier + challenge.
+ *      c. Open a one-shot loopback HTTP server on a random port.
+ *      d. Open the system browser at /authorize.
+ *      e. User signs in via auth.add.ai, picks workspace, approves.
+ *      f. Auth server 302s to http://127.0.0.1:<port>/callback?code=…
+ *      g. Loopback handler captures the code, exchanges it at /token.
+ *      h. Tokens cached; loopback server shut down.
+ *
+ * The flow is silent and non-interactive when tokens are cached and valid —
+ * only the first run and the refresh-failure path pop a browser.
+ */
+import * as http from 'node:http';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { randomBytes, createHash } from 'node:crypto';
+import { spawn } from 'node:child_process';
+const ISSUER = 'https://auth.add.ai/oauth';
+const DEFAULT_SCOPE = 'tasks.read tasks.write';
+const CONFIG_DIR = path.join(os.homedir(), '.addai', 'tasks-mcp');
+const CLIENT_FILE = path.join(CONFIG_DIR, 'client.json');
+const TOKENS_FILE = path.join(CONFIG_DIR, 'tokens.json');
+const ACCESS_TOKEN_REFRESH_SKEW_MS = 60 * 1000; // refresh 60s before expiry
+const LOOPBACK_TIMEOUT_MS = 5 * 60 * 1000; // 5 min for user to log in
+// ──────────────────────────────────────────────────────────────────────────
+// File-backed store (chmod 600 for both files; dir is 700)
+// ──────────────────────────────────────────────────────────────────────────
+async function ensureConfigDir() {
+    await fs.mkdir(CONFIG_DIR, { recursive: true, mode: 0o700 });
+}
+async function readJson(file) {
+    try {
+        const text = await fs.readFile(file, 'utf-8');
+        return JSON.parse(text);
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+async function writeJson(file, value) {
+    await ensureConfigDir();
+    await fs.writeFile(file, JSON.stringify(value, null, 2), { mode: 0o600 });
+}
+// ──────────────────────────────────────────────────────────────────────────
+// PKCE
+// ──────────────────────────────────────────────────────────────────────────
+function base64UrlEncode(buf) {
+    return buf.toString('base64')
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=+$/, '');
+}
+function newCodeVerifier() {
+    return base64UrlEncode(randomBytes(48));
+}
+function challengeFromVerifier(verifier) {
+    return base64UrlEncode(createHash('sha256').update(verifier).digest());
+}
+function newState() {
+    return base64UrlEncode(randomBytes(16));
+}
+function startLoopback(expectedState) {
+    return new Promise((resolve, reject) => {
+        const server = http.createServer();
+        let resolveWait;
+        let rejectWait;
+        const wait = new Promise((res, rej) => { resolveWait = res; rejectWait = rej; });
+        server.on('request', (req, res) => {
+            try {
+                const url = new URL(req.url || '/', `http://127.0.0.1`);
+                if (url.pathname !== '/callback') {
+                    res.writeHead(404).end('Not Found');
+                    return;
+                }
+                const err = url.searchParams.get('error');
+                if (err) {
+                    const desc = url.searchParams.get('error_description') ?? '';
+                    res.writeHead(400, { 'Content-Type': 'text/html' }).end(`<html><body><h2>Sign-in failed</h2><p>${escapeHtml(err)}: ${escapeHtml(desc)}</p><p>You can close this tab.</p></body></html>`);
+                    rejectWait(new Error(`Authorisation server returned ${err}: ${desc}`));
+                    return;
+                }
+                const code = url.searchParams.get('code');
+                const state = url.searchParams.get('state');
+                if (!code || !state) {
+                    res.writeHead(400).end('Missing code or state');
+                    rejectWait(new Error('Missing code or state in callback'));
+                    return;
+                }
+                if (state !== expectedState) {
+                    res.writeHead(400).end('State mismatch');
+                    rejectWait(new Error('State mismatch (possible CSRF)'));
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'text/html' }).end(`<html><body style="font-family:system-ui;padding:48px;text-align:center">
+            <h2>You're signed in to +Ai Tasks.</h2>
+            <p>You can close this tab and return to your terminal.</p>
+          </body></html>`);
+                resolveWait({ code, state });
+            }
+            catch (e) {
+                try {
+                    res.writeHead(500).end('Internal error');
+                }
+                catch { }
+                rejectWait(e);
+            }
+        });
+        server.on('error', (e) => reject(e));
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            const port = typeof address === 'object' && address ? address.port : 0;
+            const timeout = setTimeout(() => rejectWait(new Error(`Auth flow timed out after ${LOOPBACK_TIMEOUT_MS / 1000}s`)), LOOPBACK_TIMEOUT_MS);
+            const close = () => {
+                clearTimeout(timeout);
+                server.close();
+            };
+            resolve({ port, wait, close });
+        });
+    });
+}
+function escapeHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function openBrowser(url) {
+    const platform = process.platform;
+    const cmd = platform === 'darwin' ? 'open'
+        : platform === 'win32' ? 'cmd'
+            : 'xdg-open';
+    const args = platform === 'win32' ? ['/c', 'start', '""', url] : [url];
+    try {
+        const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+        child.unref();
+    }
+    catch {
+        // If spawning the browser fails (CI, no DE), print the URL.
+        process.stderr.write(`\nOpen this URL in your browser to sign in:\n  ${url}\n\n`);
+    }
+}
+// ──────────────────────────────────────────────────────────────────────────
+// Network helpers
+// ──────────────────────────────────────────────────────────────────────────
+async function registerClient(redirectUris) {
+    const res = await fetch(`${ISSUER}/register`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            redirect_uris: redirectUris,
+            client_name: `Claude (${safeHostname()})`,
+            scope: DEFAULT_SCOPE,
+        }),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`OAuth /register failed: ${res.status} ${text.slice(0, 200)}`);
+    }
+    const body = await res.json();
+    return {
+        client_id: body.client_id,
+        redirect_uris: body.redirect_uris,
+        client_name: body.client_name,
+        scope: body.scope,
+    };
+}
+async function exchangeCode(opts) {
+    const res = await fetch(`${ISSUER}/token`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            grant_type: 'authorization_code',
+            code: opts.code,
+            redirect_uri: opts.redirectUri,
+            client_id: opts.clientId,
+            code_verifier: opts.codeVerifier,
+        }),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`OAuth /token (code) failed: ${res.status} ${text.slice(0, 200)}`);
+    }
+    const body = await res.json();
+    return { ...body, obtained_at: Date.now() };
+}
+async function refreshTokens(opts) {
+    const res = await fetch(`${ISSUER}/token`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            grant_type: 'refresh_token',
+            refresh_token: opts.refreshToken,
+            client_id: opts.clientId,
+        }),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`OAuth /token (refresh) failed: ${res.status} ${text.slice(0, 200)}`);
+    }
+    const body = await res.json();
+    return { ...body, obtained_at: Date.now() };
+}
+function safeHostname() {
+    try {
+        return os.hostname();
+    }
+    catch {
+        return 'mcp-client';
+    }
+}
+function tokenIsFresh(t) {
+    if (!t)
+        return false;
+    const expiresAt = t.obtained_at + t.expires_in * 1000;
+    return Date.now() + ACCESS_TOKEN_REFRESH_SKEW_MS < expiresAt;
+}
+/**
+ * Returns a valid access token, performing whichever flow is needed:
+ *   - cached and fresh                          → return as-is
+ *   - cached, expired, refresh valid            → refresh, return
+ *   - cached client only, no tokens / refresh   → full browser flow
+ *   - nothing cached                            → register + full browser flow
+ */
+export async function getOAuthAccessToken(opts = {}) {
+    await ensureConfigDir();
+    const cachedClient = await readJson(CLIENT_FILE);
+    const cachedTokens = await readJson(TOKENS_FILE);
+    // Fresh access token — fast path.
+    if (cachedClient && tokenIsFresh(cachedTokens)) {
+        return {
+            accessToken: cachedTokens.access_token,
+            expiresAt: cachedTokens.obtained_at + cachedTokens.expires_in * 1000,
+            scope: cachedTokens.scope,
+        };
+    }
+    // Try refresh.
+    if (cachedClient && cachedTokens?.refresh_token) {
+        try {
+            const refreshed = await refreshTokens({
+                clientId: cachedClient.client_id,
+                refreshToken: cachedTokens.refresh_token,
+            });
+            await writeJson(TOKENS_FILE, refreshed);
+            return {
+                accessToken: refreshed.access_token,
+                expiresAt: refreshed.obtained_at + refreshed.expires_in * 1000,
+                scope: refreshed.scope,
+            };
+        }
+        catch (err) {
+            // Refresh failed — fall through to full flow.
+            process.stderr.write(`[tasks-mcp] refresh token rejected: ${err.message}\n`);
+        }
+    }
+    if (opts.interactive === false) {
+        throw new Error('OAuth flow required but interactive=false. Set ADDAI_API_KEY in env or run interactively once to authenticate.');
+    }
+    // Full browser flow.
+    const codeVerifier = newCodeVerifier();
+    const codeChallenge = challengeFromVerifier(codeVerifier);
+    const state = newState();
+    // We need the loopback port BEFORE we register so the redirect URI is known.
+    const placeholder = await startLoopback(state);
+    const redirectUri = `http://127.0.0.1:${placeholder.port}/callback`;
+    // Register (or reuse) the OAuth client.
+    let client = cachedClient;
+    const needsRegister = !client || !client.redirect_uris.some((u) => u.startsWith('http://127.0.0.1:'));
+    if (needsRegister) {
+        client = await registerClient([redirectUri]);
+        await writeJson(CLIENT_FILE, client);
+    }
+    else if (!client.redirect_uris.includes(redirectUri)) {
+        // Existing client doesn't know about this port. Re-register a new client
+        // entry rather than mutating the existing one (RFC 7591 simplicity).
+        client = await registerClient([redirectUri]);
+        await writeJson(CLIENT_FILE, client);
+    }
+    // Kick off the authorization request.
+    const authUrl = new URL(`${ISSUER}/authorize`);
+    authUrl.searchParams.set('response_type', 'code');
+    authUrl.searchParams.set('client_id', client.client_id);
+    authUrl.searchParams.set('redirect_uri', redirectUri);
+    authUrl.searchParams.set('state', state);
+    authUrl.searchParams.set('scope', client.scope);
+    authUrl.searchParams.set('code_challenge', codeChallenge);
+    authUrl.searchParams.set('code_challenge_method', 'S256');
+    process.stderr.write('[tasks-mcp] opening browser to authenticate with +Ai...\n');
+    openBrowser(authUrl.toString());
+    let callback;
+    try {
+        callback = await placeholder.wait;
+    }
+    finally {
+        placeholder.close();
+    }
+    const tokens = await exchangeCode({
+        clientId: client.client_id,
+        code: callback.code,
+        redirectUri,
+        codeVerifier,
+    });
+    await writeJson(TOKENS_FILE, tokens);
+    return {
+        accessToken: tokens.access_token,
+        expiresAt: tokens.obtained_at + tokens.expires_in * 1000,
+        scope: tokens.scope,
+    };
+}
+/** Drop cached credentials. Useful for `flows-mcp logout`. */
+export async function clearOAuthCache() {
+    await fs.rm(CLIENT_FILE, { force: true });
+    await fs.rm(TOKENS_FILE, { force: true });
+}
+//# sourceMappingURL=oauth.js.map

package/dist/oauth.js.map

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

package/dist/tools/tasks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TasksApiClient } from '../client.js';
+export declare function registerTaskTools(server: McpServer, client: TasksApiClient): void;

package/dist/tools/tasks.js

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+const reminderSchema = z.object({
+    offset_value: z
+        .number()
+        .int()
+        .describe('How long before the due date to fire this reminder, in the chosen unit (e.g. 30).'),
+    offset_unit: z
+        .enum(['minutes', 'hours', 'days'])
+        .describe('Unit for offset_value. Combined with offset_value it is measured back from the due date.'),
+    label: z
+        .string()
+        .optional()
+        .describe('Optional short label shown with the reminder (e.g. "Final reminder").'),
+});
+const linkSchema = z
+    .object({
+    database_id: z.string().describe('AiTables database id the task is linked to.'),
+    table_id: z.string().describe('AiTables table id the task is linked to.'),
+    record_id: z
+        .string()
+        .optional()
+        .describe('Specific record/row id to write back to when the task completes.'),
+    record_filters: z
+        .any()
+        .optional()
+        .describe('Filters identifying the record(s) to write back to when record_id is not known.'),
+    status_column_id: z
+        .string()
+        .describe('Id of the column in the linked table that represents completion status.'),
+    status_column_type: z
+        .enum(['select', 'boolean'])
+        .describe('Type of the status column: "select" (option value) or "boolean" (checkbox).'),
+    complete_value: z
+        .any()
+        .optional()
+        .describe('Value to set the status column to when the task is completed.'),
+    pending_value: z
+        .any()
+        .optional()
+        .describe('Value the status column should hold while the task is still pending.'),
+    revert_on_reopen: z
+        .boolean()
+        .optional()
+        .describe('If true, reverts the status column back to pending_value if the task is reopened.'),
+})
+    .describe('Optional AiTables write-back link. When the task completes, a DB trigger updates the linked record\'s status column.');
+const prioritySchema = z
+    .enum(['low', 'medium', 'high', 'urgent'])
+    .describe('Task priority. One of low, medium, high, urgent.');
+function ok(result) {
+    return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+}
+export function registerTaskTools(server, client) {
+    server.tool('create_task', 'Create a new task in the workspace tied to your API key. The task is assigned to the given user (a user_profiles id or an email); if you omit assigned_to it defaults to the entity bound to your key. Supports a due date, priority, optional reminders (each an offset before the due date), and an optional AiTables write-back link so completing the task updates a record\'s status column. Returns the created task row.', {
+        title: z.string().describe('Short title of the task (required).'),
+        description: z.string().optional().describe('Longer description / details of what needs doing.'),
+        assigned_to: z
+            .string()
+            .optional()
+            .describe('Who the task is for: a user_profiles id OR an email address. Defaults to the entity bound to your API key. If neither is resolvable the API returns 400.'),
+        due_date: z
+            .string()
+            .optional()
+            .describe('When the task is due, as an ISO 8601 timestamp (e.g. "2026-07-01T17:00:00Z").'),
+        priority: prioritySchema.optional(),
+        conversation_id: z
+            .string()
+            .optional()
+            .describe('Optional conversation id to associate the task with the chat it came from.'),
+        reminders: z
+            .array(reminderSchema)
+            .optional()
+            .describe('Optional reminders, each fired the given offset before the due date.'),
+        link: linkSchema.optional(),
+    }, async (args) => {
+        const result = await client.createTask(args);
+        return ok(result);
+    });
+    server.tool('list_tasks', 'List tasks in the workspace tied to your API key. Optionally filter by assignee (a user_profiles id or email), by status (pending or completed), and cap the number returned with limit. Returns an array of task rows.', {
+        assigned_to: z
+            .string()
+            .optional()
+            .describe('Filter to tasks assigned to this user_profiles id or email.'),
+        status: z
+            .enum(['pending', 'completed'])
+            .optional()
+            .describe('Filter by status: "pending" or "completed".'),
+        limit: z.number().int().positive().optional().describe('Maximum number of tasks to return.'),
+    }, async (args) => {
+        const result = await client.listTasks(args);
+        return ok(result);
+    });
+    server.tool('get_task', 'Fetch a single task by its id. The task must belong to the workspace tied to your API key, otherwise the API returns 404. Returns the task row.', {
+        id: z.string().describe('The task id to fetch.'),
+    }, async ({ id }) => {
+        const result = await client.getTask(id);
+        return ok(result);
+    });
+    server.tool('complete_task', 'Mark a task as completed. Sets status to completed and records who completed it. If the task has an AiTables link, a DB trigger queues the write-back to update the linked record\'s status column. Returns the updated task row.', {
+        id: z.string().describe('The task id to complete.'),
+    }, async ({ id }) => {
+        const result = await client.completeTask(id);
+        return ok(result);
+    });
+    server.tool('update_task', 'Update fields on an existing task. Pass only the fields you want to change (title, description, due_date, priority, assigned_to, or status). The task must belong to the workspace tied to your API key. Returns the updated task row.', {
+        id: z.string().describe('The task id to update.'),
+        title: z.string().optional().describe('New title.'),
+        description: z.string().optional().describe('New description.'),
+        due_date: z
+            .string()
+            .optional()
+            .describe('New due date as an ISO 8601 timestamp.'),
+        priority: prioritySchema.optional(),
+        assigned_to: z
+            .string()
+            .optional()
+            .describe('Reassign to this user_profiles id or email.'),
+        status: z
+            .enum(['pending', 'completed'])
+            .optional()
+            .describe('Set status to "pending" or "completed".'),
+    }, async ({ id, ...rest }) => {
+        const result = await client.updateTask(id, rest);
+        return ok(result);
+    });
+    server.tool('delete_task', 'Delete a task by its id. The task must belong to the workspace tied to your API key. Returns { ok: true } on success.', {
+        id: z.string().describe('The task id to delete.'),
+    }, async ({ id }) => {
+        const result = await client.deleteTask(id);
+        return ok(result);
+    });
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@addai/tasks-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for +Ai Tasks - create, list, complete, update, and delete tasks via AI assistants",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "tasks-mcp": "dist/index.js",
+    "tasks-mcp-install": "dist/bin/install.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "ai-tasks",
+    "addai",
+    "claude",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist"
+  ]
+}