copilot-money-mcp 1.7.1 → 2.0.0

package/dist/cli.js

@@ -28537,7 +28537,6 @@ function getAccountDisplayName(account) {
 }
 
 // src/models/recurring.ts
-var RECURRING_STATES = ["active", "paused", "archived"];
 var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
 var RecurringSchema = exports_external.object({
   recurring_id: exports_external.string(),
@@ -28571,7 +28570,6 @@ function getRecurringDisplayName(recurring) {
 }
 
 // src/models/budget.ts
-var KNOWN_PERIODS = ["monthly", "yearly", "weekly", "daily"];
 var DATE_REGEX2 = /^\d{4}-\d{2}-\d{2}$/;
 var BudgetSchema = exports_external.object({
   budget_id: exports_external.string(),
@@ -32208,33 +32206,661 @@ class CopilotDatabase {
   }
 }
 
-// src/core/format/firestore-rest.ts
-function toFirestoreValue(value) {
-  if (value === null)
-    return { nullValue: null };
-  if (typeof value === "string")
-    return { stringValue: value };
-  if (typeof value === "boolean")
-    return { booleanValue: value };
-  if (typeof value === "number") {
-    return Number.isInteger(value) ? { integerValue: String(value) } : { doubleValue: value };
+// src/core/graphql/client.ts
+var ENDPOINT = "https://app.copilot.money/api/graphql";
+
+class GraphQLError extends Error {
+  code;
+  operationName;
+  httpStatus;
+  serverErrors;
+  constructor(code, message, operationName, httpStatus, serverErrors) {
+    super(message);
+    this.code = code;
+    this.operationName = operationName;
+    this.httpStatus = httpStatus;
+    this.serverErrors = serverErrors;
+    this.name = "GraphQLError";
   }
-  if (Array.isArray(value)) {
-    return { arrayValue: { values: value.map(toFirestoreValue) } };
+}
+
+class GraphQLClient {
+  auth;
+  constructor(auth) {
+    this.auth = auth;
   }
-  if (typeof value === "object") {
-    return { mapValue: { fields: toFirestoreFields(value) } };
+  async mutate(operationName, query, variables) {
+    const idToken = await this.auth.getIdToken();
+    let response;
+    try {
+      response = await fetch(ENDPOINT, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${idToken}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ operationName, query, variables })
+      });
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      this.logError(operationName, "NETWORK", undefined);
+      throw new GraphQLError("NETWORK", msg, operationName);
+    }
+    if (response.status === 401) {
+      const text = await response.text().catch(() => "");
+      this.logError(operationName, "AUTH_FAILED", 401);
+      throw new GraphQLError("AUTH_FAILED", `401 Unauthorized: ${text || "no body"}`, operationName, 401);
+    }
+    if (response.status === 400 || response.status === 500) {
+      const text = await response.text().catch(() => "");
+      this.logError(operationName, "SCHEMA_ERROR", response.status);
+      throw new GraphQLError("SCHEMA_ERROR", `${response.status} Schema Error: ${text || "no body"}`, operationName, response.status);
+    }
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      this.logError(operationName, "UNKNOWN", response.status);
+      throw new GraphQLError("UNKNOWN", `${response.status}: ${text || "no body"}`, operationName, response.status);
+    }
+    let body;
+    try {
+      body = await response.json();
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      this.logError(operationName, "UNKNOWN", response.status);
+      throw new GraphQLError("UNKNOWN", `Invalid JSON response: ${msg}`, operationName, response.status);
+    }
+    if (body.errors && body.errors.length > 0) {
+      const firstMessage = body.errors[0]?.message ?? "GraphQL error (no message)";
+      this.logError(operationName, "USER_ACTION_REQUIRED", response.status);
+      throw new GraphQLError("USER_ACTION_REQUIRED", firstMessage, operationName, response.status, body.errors);
+    }
+    if (!body.data) {
+      this.logError(operationName, "UNKNOWN", response.status);
+      throw new GraphQLError("UNKNOWN", "Response missing data field", operationName, response.status);
+    }
+    return body.data;
+  }
+  logError(operationName, code, httpStatus) {
+    const statusPart = httpStatus !== undefined ? ` status=${httpStatus}` : "";
+    console.error(`[graphql] ${operationName} failed: code=${code}${statusPart}`);
   }
-  throw new Error(`Unsupported value type: ${typeof value}`);
 }
-function toFirestoreFields(obj) {
-  const fields = {};
-  for (const [key, value] of Object.entries(obj)) {
-    if (value !== undefined) {
-      fields[key] = toFirestoreValue(value);
-    }
+
+// src/core/graphql/operations.generated.ts
+var EDIT_TRANSACTION = `mutation EditTransaction($itemId: ID!, $accountId: ID!, $id: ID!, $input: EditTransactionInput) {
+  editTransaction(itemId: $itemId, accountId: $accountId, id: $id, input: $input) {
+    __typename
+    transaction {
+      __typename
+      ...TransactionFields
+    }
+  }
+}
+
+fragment TagFields on Tag {
+  __typename
+  colorName
+  name
+  id
+}
+
+fragment GoalFields on Goal {
+  __typename
+  name
+  icon {
+    __typename
+    ... on EmojiUnicode {
+      __typename
+      unicode
+    }
+    ... on Genmoji {
+      __typename
+      id
+      src
+    }
+  }
+  id
+}
+
+fragment TransactionFields on Transaction {
+  __typename
+  suggestedCategoryIds
+  recurringId
+  categoryId
+  isReviewed
+  accountId
+  createdAt
+  isPending
+  tipAmount
+  userNotes
+  itemId
+  amount
+  date
+  name
+  type
+  id
+  tags {
+    __typename
+    ...TagFields
+  }
+  goal {
+    __typename
+    ...GoalFields
+  }
+}`;
+var CREATE_CATEGORY = `mutation CreateCategory($input: CreateCategoryInput!, $spend: Boolean = false, $budget: Boolean = false) {
+  createCategory(input: $input) {
+    __typename
+    ...CategoryFields
+    spend @include(if: $spend) {
+      __typename
+      ...SpendFields
+    }
+    budget @include(if: $budget) {
+      __typename
+      ...BudgetFields
+    }
+    childCategories {
+      __typename
+      ...CategoryFields
+      spend @include(if: $spend) {
+        __typename
+        ...SpendFields
+      }
+      budget @include(if: $budget) {
+        __typename
+        ...BudgetFields
+      }
+    }
+  }
+}
+
+fragment SpendMonthlyFields on CategoryMonthlySpent {
+  __typename
+  unpaidRecurringAmount
+  paidRecurringAmount
+  comparisonAmount
+  amount
+  month
+  id
+}
+
+fragment BudgetMonthlyFields on CategoryMonthlyBudget {
+  __typename
+  unassignedRolloverAmount
+  childRolloverAmount
+  unassignedAmount
+  resolvedAmount
+  rolloverAmount
+  childAmount
+  goalAmount
+  amount
+  month
+  id
+}
+
+fragment CategoryFields on Category {
+  __typename
+  isRolloverDisabled
+  canBeDeleted
+  isExcluded
+  templateId
+  colorName
+  icon {
+    __typename
+    ... on EmojiUnicode {
+      __typename
+      unicode
+    }
+    ... on Genmoji {
+      __typename
+      id
+      src
+    }
+  }
+  name
+  id
+}
+
+fragment SpendFields on CategorySpend {
+  __typename
+  current {
+    __typename
+    ...SpendMonthlyFields
+  }
+  histories {
+    __typename
+    ...SpendMonthlyFields
+  }
+}
+
+fragment BudgetFields on CategoryBudget {
+  __typename
+  current {
+    __typename
+    ...BudgetMonthlyFields
+  }
+  histories {
+    __typename
+    ...BudgetMonthlyFields
+  }
+}`;
+var EDIT_CATEGORY = `mutation EditCategory($id: ID!, $input: EditCategoryInput!, $spend: Boolean = false, $budget: Boolean = false, $rollovers: Boolean = false) {
+  editCategory(id: $id, input: $input) {
+    __typename
+    category {
+      __typename
+      ...CategoryFields
+      spend @include(if: $spend) {
+        __typename
+        ...SpendFields
+      }
+      budget(isRolloverEnabled: $rollovers) @include(if: $budget) {
+        __typename
+        ...BudgetFields
+      }
+    }
+  }
+}
+
+fragment SpendMonthlyFields on CategoryMonthlySpent {
+  __typename
+  unpaidRecurringAmount
+  paidRecurringAmount
+  comparisonAmount
+  amount
+  month
+  id
+}
+
+fragment BudgetMonthlyFields on CategoryMonthlyBudget {
+  __typename
+  unassignedRolloverAmount
+  childRolloverAmount
+  unassignedAmount
+  resolvedAmount
+  rolloverAmount
+  childAmount
+  goalAmount
+  amount
+  month
+  id
+}
+
+fragment CategoryFields on Category {
+  __typename
+  isRolloverDisabled
+  canBeDeleted
+  isExcluded
+  templateId
+  colorName
+  icon {
+    __typename
+    ... on EmojiUnicode {
+      __typename
+      unicode
+    }
+    ... on Genmoji {
+      __typename
+      id
+      src
+    }
+  }
+  name
+  id
+}
+
+fragment SpendFields on CategorySpend {
+  __typename
+  current {
+    __typename
+    ...SpendMonthlyFields
+  }
+  histories {
+    __typename
+    ...SpendMonthlyFields
+  }
+}
+
+fragment BudgetFields on CategoryBudget {
+  __typename
+  current {
+    __typename
+    ...BudgetMonthlyFields
+  }
+  histories {
+    __typename
+    ...BudgetMonthlyFields
+  }
+}`;
+var DELETE_CATEGORY = `mutation DeleteCategory($id: ID!) {
+  deleteCategory(id: $id)
+}`;
+var CREATE_TAG = `mutation CreateTag($input: CreateTagInput!) {
+  createTag(input: $input) {
+    __typename
+    ...TagFields
+  }
+}
+
+fragment TagFields on Tag {
+  __typename
+  colorName
+  name
+  id
+}`;
+var EDIT_TAG = `mutation EditTag($id: ID!, $input: EditTagInput!) {
+  editTag(id: $id, input: $input) {
+    __typename
+    ...TagFields
+  }
+}
+
+fragment TagFields on Tag {
+  __typename
+  colorName
+  name
+  id
+}`;
+var DELETE_TAG = `mutation DeleteTag($id: ID!) {
+  deleteTag(id: $id)
+}`;
+var CREATE_RECURRING = `mutation CreateRecurring($input: CreateRecurringInput!) {
+  createRecurring(input: $input) {
+    __typename
+    ...RecurringFields
+    rule {
+      __typename
+      ...RecurringRuleFields
+    }
+    payments {
+      __typename
+      ...RecurringPaymentFields
+    }
+  }
+}
+
+fragment RecurringFields on Recurring {
+  __typename
+  nextPaymentAmount
+  nextPaymentDate
+  categoryId
+  frequency
+  emoji
+  icon {
+    __typename
+    ... on EmojiUnicode {
+      __typename
+      unicode
+    }
+    ... on Genmoji {
+      __typename
+      id
+      src
+    }
+  }
+  state
+  name
+  id
+}
+
+fragment RecurringRuleFields on RecurringRule {
+  __typename
+  nameContains
+  minAmount
+  maxAmount
+  days
+}
+
+fragment RecurringPaymentFields on RecurringPayment {
+  __typename
+  amount
+  isPaid
+  date
+}`;
+var EDIT_RECURRING = `mutation EditRecurring($id: ID!, $input: EditRecurringInput!) {
+  editRecurring(id: $id, input: $input) {
+    __typename
+    recurring {
+      __typename
+      ...RecurringFields
+      rule {
+        __typename
+        ...RecurringRuleFields
+      }
+      payments {
+        __typename
+        ...RecurringPaymentFields
+      }
+    }
+  }
+}
+
+fragment RecurringFields on Recurring {
+  __typename
+  nextPaymentAmount
+  nextPaymentDate
+  categoryId
+  frequency
+  emoji
+  icon {
+    __typename
+    ... on EmojiUnicode {
+      __typename
+      unicode
+    }
+    ... on Genmoji {
+      __typename
+      id
+      src
+    }
+  }
+  state
+  name
+  id
+}
+
+fragment RecurringRuleFields on RecurringRule {
+  __typename
+  nameContains
+  minAmount
+  maxAmount
+  days
+}
+
+fragment RecurringPaymentFields on RecurringPayment {
+  __typename
+  amount
+  isPaid
+  date
+}`;
+var DELETE_RECURRING = `mutation DeleteRecurring($deleteRecurringId: ID!) {
+  deleteRecurring(id: $deleteRecurringId)
+}`;
+var EDIT_BUDGET = `mutation EditBudget($categoryId: ID!, $input: EditCategoryBudgetInput!) {
+  editCategoryBudget(categoryId: $categoryId, input: $input)
+}`;
+var EDIT_BUDGET_MONTHLY = `mutation EditBudgetMonthly($categoryId: ID!, $input: [EditCategoryBudgetMonthlyInput!]!) {
+  editCategoryBudgetMonthly(categoryId: $categoryId, input: $input)
+}`;
+
+// src/core/graphql/transactions.ts
+async function editTransaction(client, args) {
+  const data = await client.mutate("EditTransaction", EDIT_TRANSACTION, args);
+  const tx = data.editTransaction.transaction;
+  const changed = {};
+  if ("categoryId" in args.input)
+    changed.categoryId = tx.categoryId;
+  if ("userNotes" in args.input)
+    changed.userNotes = tx.userNotes;
+  if ("isReviewed" in args.input)
+    changed.isReviewed = tx.isReviewed;
+  if ("tagIds" in args.input)
+    changed.tagIds = tx.tags.map((t) => t.id);
+  return { id: tx.id, changed };
+}
+
+// src/core/graphql/categories.ts
+async function createCategory(client, args) {
+  const data = await client.mutate("CreateCategory", CREATE_CATEGORY, { spend: false, budget: false, input: args.input });
+  return {
+    id: data.createCategory.id,
+    name: data.createCategory.name,
+    colorName: data.createCategory.colorName
+  };
+}
+async function editCategory(client, args) {
+  const data = await client.mutate("EditCategory", EDIT_CATEGORY, {
+    id: args.id,
+    spend: false,
+    budget: false,
+    input: args.input
+  });
+  const cat = data.editCategory.category;
+  const changed = {};
+  if ("name" in args.input)
+    changed.name = cat.name;
+  if ("colorName" in args.input)
+    changed.colorName = cat.colorName;
+  if ("emoji" in args.input)
+    changed.emoji = args.input.emoji;
+  if ("isExcluded" in args.input)
+    changed.isExcluded = args.input.isExcluded;
+  return { id: cat.id, changed };
+}
+async function deleteCategory(client, args) {
+  await client.mutate("DeleteCategory", DELETE_CATEGORY, { id: args.id });
+  return { id: args.id, deleted: true };
+}
+
+// src/core/graphql/tags.ts
+async function createTag(client, args) {
+  const data = await client.mutate("CreateTag", CREATE_TAG, args);
+  return {
+    id: data.createTag.id,
+    name: data.createTag.name,
+    colorName: data.createTag.colorName
+  };
+}
+async function editTag(client, args) {
+  const data = await client.mutate("EditTag", EDIT_TAG, args);
+  const tag = data.editTag;
+  const changed = {};
+  if ("name" in args.input)
+    changed.name = tag.name;
+  if ("colorName" in args.input)
+    changed.colorName = tag.colorName;
+  return { id: tag.id, changed };
+}
+async function deleteTag(client, args) {
+  await client.mutate("DeleteTag", DELETE_TAG, {
+    id: args.id
+  });
+  return { id: args.id, deleted: true };
+}
+
+// src/core/graphql/recurrings.ts
+async function createRecurring(client, args) {
+  const data = await client.mutate("CreateRecurring", CREATE_RECURRING, args);
+  return {
+    id: data.createRecurring.id,
+    name: data.createRecurring.name,
+    state: data.createRecurring.state,
+    frequency: data.createRecurring.frequency
+  };
+}
+function toFloatOrThrow(value, path3) {
+  if (!/^\d+(\.\d+)?$/.test(value)) {
+    throw new Error(`editRecurring: invalid ${path3} ${value}`);
+  }
+  const n = parseFloat(value);
+  if (!Number.isFinite(n) || n < 0) {
+    throw new Error(`editRecurring: invalid ${path3} ${value}`);
+  }
+  return n;
+}
+async function editRecurring(client, args) {
+  const wireInput = {};
+  if ("state" in args.input)
+    wireInput.state = args.input.state;
+  if ("rule" in args.input && args.input.rule) {
+    const rule = args.input.rule;
+    const wireRule = {};
+    if ("nameContains" in rule)
+      wireRule.nameContains = rule.nameContains;
+    if ("minAmount" in rule && rule.minAmount !== undefined) {
+      wireRule.minAmount = toFloatOrThrow(rule.minAmount, "rule.minAmount");
+    }
+    if ("maxAmount" in rule && rule.maxAmount !== undefined) {
+      wireRule.maxAmount = toFloatOrThrow(rule.maxAmount, "rule.maxAmount");
+    }
+    if ("days" in rule)
+      wireRule.days = rule.days;
+    wireInput.rule = wireRule;
+  }
+  const data = await client.mutate("EditRecurring", EDIT_RECURRING, { id: args.id, input: wireInput });
+  const recurring = data.editRecurring.recurring;
+  const changed = {};
+  if ("state" in args.input)
+    changed.state = recurring.state;
+  if ("rule" in args.input && recurring.rule) {
+    const serverRule = recurring.rule;
+    const stringRule = {};
+    if ("nameContains" in serverRule)
+      stringRule.nameContains = serverRule.nameContains;
+    if ("minAmount" in serverRule && serverRule.minAmount !== undefined) {
+      stringRule.minAmount = String(serverRule.minAmount);
+    }
+    if ("maxAmount" in serverRule && serverRule.maxAmount !== undefined) {
+      stringRule.maxAmount = String(serverRule.maxAmount);
+    }
+    if ("days" in serverRule)
+      stringRule.days = serverRule.days;
+    changed.rule = stringRule;
+  }
+  return { id: recurring.id, changed };
+}
+async function deleteRecurring(client, args) {
+  await client.mutate("DeleteRecurring", DELETE_RECURRING, { deleteRecurringId: args.id });
+  return { id: args.id, deleted: true };
+}
+
+// src/core/graphql/budgets.ts
+async function setBudget(client, args) {
+  const cleared = args.amount === "0";
+  const amountFloat = parseFloat(args.amount);
+  if (!Number.isFinite(amountFloat) || amountFloat < 0) {
+    throw new Error(`setBudget: invalid amount ${args.amount}`);
+  }
+  if (args.month) {
+    await client.mutate("EditBudgetMonthly", EDIT_BUDGET_MONTHLY, {
+      categoryId: args.categoryId,
+      input: [{ amount: amountFloat, month: args.month }]
+    });
+    return { categoryId: args.categoryId, amount: args.amount, month: args.month, cleared };
+  }
+  await client.mutate("EditBudget", EDIT_BUDGET, {
+    categoryId: args.categoryId,
+    input: { amount: amountFloat }
+  });
+  return { categoryId: args.categoryId, amount: args.amount, cleared };
+}
+
+// src/tools/errors.ts
+function graphQLErrorToMcpError(e) {
+  switch (e.code) {
+    case "AUTH_FAILED":
+      return "Authentication with Copilot failed. Sign in to the Copilot web app and try again.";
+    case "SCHEMA_ERROR":
+      return "Copilot's API changed in a way this tool doesn't handle yet. Please report this issue.";
+    case "USER_ACTION_REQUIRED":
+      return e.message;
+    case "NETWORK":
+      return `Network error contacting Copilot: ${e.message}`;
+    case "UNKNOWN":
+    default:
+      return `Copilot API request failed: ${e.message}`;
   }
-  return fields;
 }
 
 // src/utils/date.ts
@@ -32317,28 +32943,11 @@ function validateDocId(id, label) {
     throw new Error(`Invalid ${label} format: ${id}`);
   }
 }
-var HEX_COLOR_RE = /^#[0-9A-Fa-f]{6}$/;
-function validateHexColor(color) {
-  if (!HEX_COLOR_RE.test(color)) {
-    throw new Error(`Invalid color format: ${color} (expected #RRGGBB)`);
-  }
-}
-function hexToBgColor(hex3) {
-  const r = parseInt(hex3.slice(1, 3), 16);
-  const g = parseInt(hex3.slice(3, 5), 16);
-  const b = parseInt(hex3.slice(5, 7), 16);
-  const t = 0.05;
-  const blend = (c) => Math.round(255 - t * (255 - c));
-  const toHex = (n) => n.toString(16).padStart(2, "0").toUpperCase();
-  return `#${toHex(blend(r))}${toHex(blend(g))}${toHex(blend(b))}`;
-}
 var CATEGORY_FOREIGN_TX_FEE_SNAKE = "bank_fees_foreign_transaction_fees";
 var CATEGORY_FOREIGN_TX_FEE_NUMERIC = "10005000";
 var MAX_QUERY_LIMIT = 1e4;
 var DEFAULT_QUERY_LIMIT = 100;
 var MIN_QUERY_LIMIT = 1;
-var REVIEW_BATCH_SIZE = 10;
-var VALID_RECURRING_FREQUENCIES = ["weekly", "biweekly", "monthly", "yearly"];
 function validateLimit(limit, defaultValue = DEFAULT_QUERY_LIMIT) {
   if (limit === undefined)
     return defaultValue;
@@ -32417,18 +33026,18 @@ function normalizeMerchantName(name) {
 
 class CopilotMoneyTools {
   db;
-  firestoreClient;
+  graphqlClient;
   _userCategoryMap = null;
   _excludedCategoryIds = null;
-  constructor(database, firestoreClient) {
+  constructor(database, graphqlClient) {
     this.db = database;
-    this.firestoreClient = firestoreClient ?? null;
+    this.graphqlClient = graphqlClient ?? null;
   }
-  getFirestoreClient() {
-    if (!this.firestoreClient) {
-      throw new Error("Write mode is not enabled. Start the server with --write to use write tools.");
+  getGraphQLClient() {
+    if (!this.graphqlClient) {
+      throw new Error("Write tools require --write flag to be set");
     }
-    return this.firestoreClient;
+    return this.graphqlClient;
   }
   async getUserCategoryMap() {
     if (this._userCategoryMap === null) {
@@ -33451,92 +34060,41 @@ class CopilotMoneyTools {
     };
   }
   async createCategory(args) {
-    const client = this.getFirestoreClient();
-    const { name, emoji: emoji3, color, parent_category_id, excluded = false } = args;
-    if (!name.trim()) {
+    const client = this.getGraphQLClient();
+    if (!args.name?.trim())
       throw new Error("Category name must not be empty");
+    if (!args.color_name?.trim())
+      throw new Error("color_name is required");
+    if (!args.emoji?.trim())
+      throw new Error("emoji is required");
+    if (args.parent_id !== undefined) {
+      throw new Error("parent_id is not supported on create_category: Copilot's GraphQL API " + "does not accept parentId on CreateCategoryInput. Create the category " + "without a parent; the Copilot web app does not currently expose a " + "mutation to re-parent categories.");
     }
-    const existingCategories = await this.db.getUserCategories();
-    if (parent_category_id) {
-      validateDocId(parent_category_id, "parent_category_id");
-      const parent = existingCategories.find((c) => c.category_id === parent_category_id);
-      if (!parent) {
-        throw new Error(`Parent category not found: ${parent_category_id}`);
-      }
-    }
-    const duplicate = existingCategories.find((c) => c.name?.toLowerCase() === name.trim().toLowerCase());
-    if (duplicate) {
-      throw new Error(`Category with name "${name.trim()}" already exists (id: ${duplicate.category_id})`);
-    }
-    const userIdFromCategories = existingCategories.find((c) => c.user_id)?.user_id;
-    const userId = userIdFromCategories ?? await client.requireUserId();
-    const maxOrder = existingCategories.reduce((max, c) => Math.max(max, typeof c.order === "number" ? c.order : -1), -1);
-    const trimmedName = name.trim();
-    if (color)
-      validateHexColor(color);
-    const categoryColor = color ?? "#808080";
-    const categoryEmoji = emoji3 ?? "\uD83D\uDCC1";
-    const docFields = {
-      name: trimmedName,
-      emoji: categoryEmoji,
-      color: categoryColor,
-      bg_color: hexToBgColor(categoryColor),
-      order: maxOrder + 1,
-      excluded,
-      is_other: false,
-      auto_budget_lock: false,
-      auto_delete_lock: false,
-      plaid_category_ids: [],
-      partial_name_rules: []
-    };
-    if (parent_category_id)
-      docFields.parent_category_id = parent_category_id;
-    const collectionPath = `users/${userId}/categories`;
-    const firestoreFields = toFirestoreFields(docFields);
-    const categoryId = await client.createDocument(collectionPath, undefined, firestoreFields);
-    const idFields = toFirestoreFields({ id: categoryId });
-    await client.updateDocument(collectionPath, categoryId, idFields, ["id"]);
-    this.db.clearCache();
-    this._userCategoryMap = null;
-    const result = {
-      success: true,
-      category_id: categoryId,
-      name: trimmedName,
-      emoji: categoryEmoji,
-      color: categoryColor,
-      excluded
-    };
-    if (parent_category_id)
-      result.parent_category_id = parent_category_id;
-    return result;
-  }
-  async resolveTransaction(transactionId) {
-    validateDocId(transactionId, "transaction_id");
-    const transactions = await this.db.getAllTransactions();
-    const txn = transactions.find((t) => t.transaction_id === transactionId);
-    if (!txn) {
-      throw new Error(`Transaction not found: ${transactionId}`);
-    }
-    if (!txn.item_id || !txn.account_id) {
-      throw new Error(`Transaction ${transactionId} is missing item_id or account_id — cannot determine Firestore path`);
+    try {
+      const result = await createCategory(client, {
+        input: {
+          name: args.name.trim(),
+          colorName: args.color_name,
+          emoji: args.emoji,
+          isExcluded: args.is_excluded ?? false
+        }
+      });
+      return {
+        success: true,
+        category_id: result.id,
+        name: result.name,
+        color_name: result.colorName
+      };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
     }
-    return {
-      txn,
-      collectionPath: `items/${txn.item_id}/accounts/${txn.account_id}/transactions`
-    };
   }
   async updateTransaction(args) {
+    const client = this.getGraphQLClient();
     const { transaction_id } = args;
-    const allowedKeys = new Set([
-      "transaction_id",
-      "category_id",
-      "note",
-      "tag_ids",
-      "excluded",
-      "name",
-      "internal_transfer",
-      "goal_id"
-    ]);
+    const allowedKeys = new Set(["transaction_id", "category_id", "note", "tag_ids"]);
     for (const key of Object.keys(args)) {
       if (!allowedKeys.has(key)) {
         throw new Error(`update_transaction: unknown field "${key}"`);
@@ -33546,19 +34104,16 @@ class CopilotMoneyTools {
     if (mutableKeys.length === 0) {
       throw new Error("update_transaction requires at least one field to update");
     }
-    const { collectionPath } = await this.resolveTransaction(transaction_id);
-    let trimmedName;
-    if ("name" in args && args.name !== undefined) {
-      trimmedName = args.name.trim();
-      if (trimmedName.length === 0) {
-        throw new Error("Transaction name must not be empty");
-      }
+    validateDocId(transaction_id, "transaction_id");
+    const allTxns = await this.db.getAllTransactions();
+    const txn = allTxns.find((t) => t.transaction_id === transaction_id);
+    if (!txn) {
+      throw new Error(`Transaction not found: ${transaction_id}`);
     }
     if ("category_id" in args && args.category_id !== undefined) {
       validateDocId(args.category_id, "category_id");
       const categories = await this.db.getUserCategories();
-      const category = categories.find((c) => c.category_id === args.category_id);
-      if (!category) {
+      if (!categories.find((c) => c.category_id === args.category_id)) {
         throw new Error(`Category not found: ${args.category_id}`);
       }
     }
@@ -33575,61 +34130,44 @@ class CopilotMoneyTools {
         }
       }
     }
-    if ("goal_id" in args && args.goal_id !== null && args.goal_id !== undefined) {
-      validateDocId(args.goal_id, "goal_id");
-      const goals = await this.db.getGoals();
-      const goal = goals.find((g) => g.goal_id === args.goal_id);
-      if (!goal) {
-        throw new Error(`Goal not found: ${args.goal_id}`);
-      }
-    }
-    const firestoreFields = {};
-    const cacheFields = {};
-    if ("category_id" in args && args.category_id !== undefined) {
-      firestoreFields.category_id = args.category_id;
-      cacheFields.category_id = args.category_id;
+    const input = {};
+    if ("category_id" in args && args.category_id !== undefined)
+      input.categoryId = args.category_id;
+    if ("note" in args && args.note !== undefined)
+      input.userNotes = args.note;
+    if ("tag_ids" in args && args.tag_ids !== undefined)
+      input.tagIds = args.tag_ids;
+    if (!txn.account_id || !txn.item_id) {
+      throw new Error(`Transaction ${transaction_id} missing account_id or item_id in local cache`);
     }
-    if ("note" in args && args.note !== undefined) {
-      firestoreFields.user_note = args.note;
-      cacheFields.user_note = args.note;
+    try {
+      const result = await editTransaction(client, {
+        id: transaction_id,
+        accountId: txn.account_id,
+        itemId: txn.item_id,
+        input
+      });
+      const graphqlToApiName = {
+        categoryId: "category_id",
+        userNotes: "note",
+        tagIds: "tag_ids",
+        isReviewed: "reviewed"
+      };
+      const updated = Object.keys(result.changed).map((k) => graphqlToApiName[k] ?? k);
+      return {
+        success: true,
+        transaction_id: result.id,
+        updated
+      };
+    } catch (e) {
+      if (e instanceof GraphQLError) {
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      }
+      throw e;
     }
-    if ("tag_ids" in args && args.tag_ids !== undefined) {
-      firestoreFields.tag_ids = args.tag_ids;
-      cacheFields.tag_ids = args.tag_ids;
-    }
-    if ("excluded" in args && args.excluded !== undefined) {
-      firestoreFields.excluded = args.excluded;
-      cacheFields.excluded = args.excluded;
-    }
-    if ("name" in args && trimmedName !== undefined) {
-      firestoreFields.name = trimmedName;
-      cacheFields.name = trimmedName;
-    }
-    if ("internal_transfer" in args && args.internal_transfer !== undefined) {
-      firestoreFields.internal_transfer = args.internal_transfer;
-      cacheFields.internal_transfer = args.internal_transfer;
-    }
-    if ("goal_id" in args && args.goal_id !== undefined) {
-      firestoreFields.goal_id = args.goal_id ?? "";
-      cacheFields.goal_id = args.goal_id ?? undefined;
-    }
-    const client = this.getFirestoreClient();
-    const firestoreValue = toFirestoreFields(firestoreFields);
-    const updateMask = Object.keys(firestoreFields);
-    await client.updateDocument(collectionPath, transaction_id, firestoreValue, updateMask);
-    if (!this.db.patchCachedTransaction(transaction_id, cacheFields)) {
-      this.db.clearCache();
-    }
-    const firestoreToApiName = { user_note: "note" };
-    const updated = updateMask.map((k) => firestoreToApiName[k] ?? k);
-    return {
-      success: true,
-      transaction_id,
-      updated
-    };
   }
   async reviewTransactions(args) {
-    const client = this.getFirestoreClient();
+    const client = this.getGraphQLClient();
     const { transaction_ids, reviewed = true } = args;
     if (!Array.isArray(transaction_ids) || transaction_ids.length === 0) {
       throw new Error("transaction_ids must be a non-empty array");
@@ -33639,663 +34177,274 @@ class CopilotMoneyTools {
     }
     const allTransactions = await this.db.getAllTransactions();
     const txnMap = new Map(allTransactions.map((t) => [t.transaction_id, t]));
-    const resolvedTxns = [];
+    const missing = transaction_ids.filter((id) => !txnMap.has(id));
+    if (missing.length > 0) {
+      throw new Error(`Transactions not found: ${missing.join(", ")}`);
+    }
     for (const id of transaction_ids) {
       const txn = txnMap.get(id);
-      if (!txn) {
-        throw new Error(`Transaction not found: ${id}`);
-      }
-      if (!txn.item_id || !txn.account_id) {
-        throw new Error(`Transaction ${id} is missing item_id or account_id — cannot determine Firestore path`);
+      if (!txn.account_id || !txn.item_id) {
+        throw new Error(`Transaction ${id} missing account_id or item_id in local cache`);
       }
-      resolvedTxns.push(txn);
     }
-    const firestoreFields = toFirestoreFields({ user_reviewed: reviewed });
-    for (let i = 0;i < resolvedTxns.length; i += REVIEW_BATCH_SIZE) {
-      const batch = resolvedTxns.slice(i, i + REVIEW_BATCH_SIZE);
-      await Promise.all(batch.map(async (txn) => {
-        const collectionPath = `items/${txn.item_id}/accounts/${txn.account_id}/transactions`;
-        await client.updateDocument(collectionPath, txn.transaction_id, firestoreFields, [
-          "user_reviewed"
-        ]);
-        if (!this.db.patchCachedTransaction(txn.transaction_id, { user_reviewed: reviewed })) {
-          this.db.clearCache();
+    const CONCURRENCY = 5;
+    let reviewed_count = 0;
+    let firstError = null;
+    let cursor = 0;
+    const worker = async () => {
+      while (true) {
+        if (firstError)
+          return;
+        const idx = cursor++;
+        if (idx >= transaction_ids.length)
+          return;
+        const id = transaction_ids[idx];
+        const txn = txnMap.get(id);
+        try {
+          await editTransaction(client, {
+            id,
+            accountId: txn.account_id,
+            itemId: txn.item_id,
+            input: { isReviewed: reviewed }
+          });
+          reviewed_count++;
+        } catch (e) {
+          if (!firstError)
+            firstError = { id, error: e };
+          return;
         }
-      }));
+      }
+    };
+    const workerCount = Math.min(CONCURRENCY, transaction_ids.length);
+    await Promise.all(Array.from({ length: workerCount }, () => worker()));
+    if (firstError) {
+      const { id, error: error48 } = firstError;
+      if (error48 instanceof GraphQLError) {
+        throw new Error(`review_transactions failed at id=${id} (${reviewed_count}/${transaction_ids.length} succeeded): ${graphQLErrorToMcpError(error48)}`, { cause: error48 });
+      }
+      throw error48;
     }
     return {
       success: true,
-      reviewed_count: resolvedTxns.length,
-      transaction_ids: resolvedTxns.map((t) => t.transaction_id)
+      reviewed_count,
+      transaction_ids
     };
   }
   async createTag(args) {
-    const client = this.getFirestoreClient();
-    const { name, color_name, hex_color } = args;
-    const trimmedName = name.trim();
-    if (!trimmedName) {
+    const client = this.getGraphQLClient();
+    if (!args.name?.trim())
       throw new Error("Tag name must not be empty");
+    const colorName = args.color_name ?? "PURPLE2";
+    try {
+      const result = await createTag(client, {
+        input: { name: args.name.trim(), colorName }
+      });
+      return {
+        success: true,
+        tag_id: result.id,
+        name: result.name,
+        color_name: result.colorName
+      };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
     }
-    const tag_id = trimmedName.toLowerCase().replace(/\s+/g, "_").replace(/[^a-z0-9_-]/g, "");
-    if (!tag_id) {
-      throw new Error(`Cannot generate a valid tag_id from name: ${trimmedName}`);
-    }
-    if (hex_color !== undefined)
-      validateHexColor(hex_color);
-    const existingTags = await this.db.getTags();
-    const duplicate = existingTags.find((t) => t.tag_id === tag_id);
-    if (duplicate) {
-      throw new Error(`Tag "${trimmedName}" already exists (id: ${tag_id})`);
-    }
-    const userId = await client.requireUserId();
-    const docFields = { name: trimmedName };
-    if (color_name !== undefined)
-      docFields.color_name = color_name;
-    if (hex_color !== undefined)
-      docFields.hex_color = hex_color;
-    const firestoreFields = toFirestoreFields(docFields);
-    const collectionPath = `users/${userId}/tags`;
-    await client.createDocument(collectionPath, tag_id, firestoreFields);
-    this.db.clearCache();
-    const result = {
-      success: true,
-      tag_id,
-      name: trimmedName
-    };
-    if (color_name !== undefined)
-      result.color_name = color_name;
-    if (hex_color !== undefined)
-      result.hex_color = hex_color;
-    return result;
   }
   async deleteTag(args) {
-    const client = this.getFirestoreClient();
-    const { tag_id } = args;
-    validateDocId(tag_id, "tag_id");
-    const existingTags = await this.db.getTags();
-    const tag = existingTags.find((t) => t.tag_id === tag_id);
-    if (!tag) {
-      throw new Error(`Tag not found: ${tag_id}`);
-    }
-    const userId = await client.requireUserId();
-    const collectionPath = `users/${userId}/tags`;
-    await client.deleteDocument(collectionPath, tag_id);
-    this.db.clearCache();
-    return {
-      success: true,
-      tag_id,
-      deleted_name: tag.name ?? tag_id
-    };
+    const client = this.getGraphQLClient();
+    try {
+      const result = await deleteTag(client, { id: args.tag_id });
+      return { success: true, tag_id: result.id, deleted: true };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
+    }
   }
   async updateCategory(args) {
-    const client = this.getFirestoreClient();
-    const { category_id, name, emoji: emoji3, color, excluded, parent_category_id } = args;
-    validateDocId(category_id, "category_id");
-    const existingCategories = await this.db.getUserCategories();
-    const category = existingCategories.find((c) => c.category_id === category_id);
-    if (!category) {
-      throw new Error(`Category not found: ${category_id}`);
-    }
-    const fieldsToUpdate = {};
-    const updateMask = [];
-    if (name !== undefined) {
-      const trimmedName = name.trim();
-      if (!trimmedName) {
-        throw new Error("Category name must not be empty");
-      }
-      const duplicate = existingCategories.find((c) => c.category_id !== category_id && c.name?.toLowerCase() === trimmedName.toLowerCase());
-      if (duplicate) {
-        throw new Error(`Category with name "${trimmedName}" already exists (id: ${duplicate.category_id})`);
-      }
-      fieldsToUpdate.name = trimmedName;
-      updateMask.push("name");
-    }
-    if (emoji3 !== undefined) {
-      fieldsToUpdate.emoji = emoji3;
-      updateMask.push("emoji");
-    }
-    if (color !== undefined) {
-      validateHexColor(color);
-      fieldsToUpdate.color = color;
-      fieldsToUpdate.bg_color = hexToBgColor(color);
-      updateMask.push("color", "bg_color");
-    }
-    if (excluded !== undefined) {
-      fieldsToUpdate.excluded = excluded;
-      updateMask.push("excluded");
-    }
-    if (parent_category_id !== undefined) {
-      if (parent_category_id !== null) {
-        validateDocId(parent_category_id, "parent_category_id");
-        if (parent_category_id === category_id) {
-          throw new Error("A category cannot be its own parent");
-        }
-        const parent = existingCategories.find((c) => c.category_id === parent_category_id);
-        if (!parent) {
-          throw new Error(`Parent category not found: ${parent_category_id}`);
-        }
-      }
-      fieldsToUpdate.parent_category_id = parent_category_id ?? "";
-      updateMask.push("parent_category_id");
-    }
-    if (updateMask.length === 0) {
-      throw new Error("No fields to update");
-    }
-    const userIdFromCategories = existingCategories.find((c) => c.user_id)?.user_id;
-    const userId = userIdFromCategories ?? await client.requireUserId();
-    const collectionPath = `users/${userId}/categories`;
-    const firestoreFields = toFirestoreFields(fieldsToUpdate);
-    await client.updateDocument(collectionPath, category_id, firestoreFields, updateMask);
-    this.db.clearCache();
-    this._userCategoryMap = null;
-    return {
-      success: true,
-      category_id,
-      updated_fields: updateMask
-    };
+    const client = this.getGraphQLClient();
+    const input = {};
+    if (args.name !== undefined)
+      input.name = args.name;
+    if (args.color_name !== undefined)
+      input.colorName = args.color_name;
+    if (args.emoji !== undefined)
+      input.emoji = args.emoji;
+    if (args.is_excluded !== undefined)
+      input.isExcluded = args.is_excluded;
+    if (Object.keys(input).length === 0) {
+      throw new Error("update_category requires at least one field to update");
+    }
+    try {
+      const result = await editCategory(client, { id: args.category_id, input });
+      return {
+        success: true,
+        category_id: result.id,
+        updated: Object.keys(result.changed)
+      };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
+    }
   }
   async deleteCategory(args) {
-    const client = this.getFirestoreClient();
-    const { category_id } = args;
-    validateDocId(category_id, "category_id");
-    const existingCategories = await this.db.getUserCategories();
-    const category = existingCategories.find((c) => c.category_id === category_id);
-    if (!category) {
-      throw new Error(`Category not found: ${category_id}`);
-    }
-    const userIdFromCategories = existingCategories.find((c) => c.user_id)?.user_id;
-    const userId = userIdFromCategories ?? await client.requireUserId();
-    const collectionPath = `users/${userId}/categories`;
-    await client.deleteDocument(collectionPath, category_id);
-    this.db.clearCache();
-    this._userCategoryMap = null;
-    return {
-      success: true,
-      category_id,
-      deleted_name: category.name ?? category_id
-    };
-  }
-  async createBudget(args) {
-    const client = this.getFirestoreClient();
-    const { category_id, amount, period = "monthly", name } = args;
-    validateDocId(category_id, "category_id");
-    if (amount <= 0) {
-      throw new Error("Budget amount must be greater than 0");
-    }
-    if (!KNOWN_PERIODS.includes(period)) {
-      throw new Error(`Invalid period: ${period}. Must be one of: ${KNOWN_PERIODS.join(", ")}`);
-    }
-    const categories = await this.db.getUserCategories();
-    const category = categories.find((c) => c.category_id === category_id);
-    if (!category) {
-      throw new Error(`Category not found: ${category_id}`);
-    }
-    const existingBudgets = await this.db.getBudgets();
-    const duplicate = existingBudgets.find((b) => b.category_id === category_id);
-    if (duplicate) {
-      throw new Error(`A budget already exists for category "${category_id}" (budget_id: ${duplicate.budget_id})`);
-    }
-    const budgetId = `budget_${crypto.randomUUID().replace(/-/g, "").slice(0, 16)}`;
-    const userId = await client.requireUserId();
-    const docFields = {
-      budget_id: budgetId,
-      category_id,
-      amount,
-      period,
-      is_active: true
-    };
-    if (name)
-      docFields.name = name;
-    const collectionPath = `users/${userId}/budgets`;
-    const firestoreFields = toFirestoreFields(docFields);
-    await client.createDocument(collectionPath, budgetId, firestoreFields);
-    this.db.clearCache();
-    const result = {
-      success: true,
-      budget_id: budgetId,
-      category_id,
-      amount,
-      period
-    };
-    if (name)
-      result.name = name;
-    return result;
-  }
-  async updateBudget(args) {
-    const client = this.getFirestoreClient();
-    const { budget_id, amount, period, name, is_active } = args;
-    validateDocId(budget_id, "budget_id");
-    const existingBudgets = await this.db.getBudgets();
-    const budget = existingBudgets.find((b) => b.budget_id === budget_id);
-    if (!budget) {
-      throw new Error(`Budget not found: ${budget_id}`);
-    }
-    const updateFields = {};
-    const updatedFieldNames = [];
-    if (amount !== undefined) {
-      if (amount <= 0) {
-        throw new Error("Budget amount must be greater than 0");
-      }
-      updateFields.amount = amount;
-      updatedFieldNames.push("amount");
-    }
-    if (period !== undefined) {
-      if (!KNOWN_PERIODS.includes(period)) {
-        throw new Error(`Invalid period: ${period}. Must be one of: ${KNOWN_PERIODS.join(", ")}`);
-      }
-      updateFields.period = period;
-      updatedFieldNames.push("period");
-    }
-    if (name !== undefined) {
-      const trimmedName = name.trim();
-      if (!trimmedName) {
-        throw new Error("Budget name must not be empty");
-      }
-      updateFields.name = trimmedName;
-      updatedFieldNames.push("name");
-    }
-    if (is_active !== undefined) {
-      updateFields.is_active = is_active;
-      updatedFieldNames.push("is_active");
-    }
-    if (updatedFieldNames.length === 0) {
-      throw new Error("No fields to update. Provide at least one of: amount, period, name, is_active");
-    }
-    const userId = await client.requireUserId();
-    const collectionPath = `users/${userId}/budgets`;
-    const firestoreFields = toFirestoreFields(updateFields);
-    await client.updateDocument(collectionPath, budget_id, firestoreFields, updatedFieldNames);
-    this.db.clearCache();
-    return {
-      success: true,
-      budget_id,
-      updated_fields: updatedFieldNames
-    };
-  }
-  async deleteBudget(args) {
-    const client = this.getFirestoreClient();
-    const { budget_id } = args;
-    validateDocId(budget_id, "budget_id");
-    const existingBudgets = await this.db.getBudgets();
-    const budget = existingBudgets.find((b) => b.budget_id === budget_id);
-    if (!budget) {
-      throw new Error(`Budget not found: ${budget_id}`);
-    }
-    const userId = await client.requireUserId();
-    const collectionPath = `users/${userId}/budgets`;
-    await client.deleteDocument(collectionPath, budget_id);
-    this.db.clearCache();
-    return {
-      success: true,
-      budget_id,
-      deleted_name: budget.name ?? budget.category_id ?? budget_id
-    };
-  }
-  async setRecurringState(args) {
-    const client = this.getFirestoreClient();
-    const { recurring_id, state } = args;
-    validateDocId(recurring_id, "recurring_id");
-    if (!RECURRING_STATES.includes(state)) {
-      throw new Error(`Invalid state: ${state}. Must be one of: ${RECURRING_STATES.join(", ")}`);
-    }
-    const allRecurring = await this.db.getRecurring(false);
-    const recurring = allRecurring.find((r) => r.recurring_id === recurring_id);
-    if (!recurring) {
-      throw new Error(`Recurring item not found: ${recurring_id}`);
-    }
-    const displayName = getRecurringDisplayName(recurring);
-    const oldState = recurring.state ?? (recurring.is_active ? "active" : "paused");
-    const userId = await client.requireUserId();
-    const is_active = state === "active";
-    const firestoreFields = toFirestoreFields({ state, is_active });
-    const collectionPath = `users/${userId}/recurring`;
-    await client.updateDocument(collectionPath, recurring_id, firestoreFields, [
-      "state",
-      "is_active"
-    ]);
-    this.db.clearCache();
-    return {
-      success: true,
-      recurring_id,
-      name: displayName,
-      old_state: oldState,
-      new_state: state
-    };
-  }
-  async deleteRecurring(args) {
-    const client = this.getFirestoreClient();
-    const { recurring_id } = args;
-    validateDocId(recurring_id, "recurring_id");
-    const allRecurring = await this.db.getRecurring(false);
-    const recurring = allRecurring.find((r) => r.recurring_id === recurring_id);
-    if (!recurring) {
-      throw new Error(`Recurring item not found: ${recurring_id}`);
-    }
-    const displayName = getRecurringDisplayName(recurring);
-    const userId = await client.requireUserId();
-    const collectionPath = `users/${userId}/recurring`;
-    await client.deleteDocument(collectionPath, recurring_id);
-    this.db.clearCache();
-    return {
-      success: true,
-      recurring_id,
-      deleted_name: displayName
-    };
-  }
-  async updateGoal(args) {
-    const client = this.getFirestoreClient();
-    const { goal_id, name, emoji: emoji3, target_amount, monthly_contribution, status } = args;
-    validateDocId(goal_id, "goal_id");
-    const goals = await this.db.getGoals(false);
-    const goal = goals.find((g) => g.goal_id === goal_id);
-    if (!goal) {
-      throw new Error(`Goal not found: ${goal_id}`);
-    }
-    const fieldsToUpdate = {};
-    const updateMask = [];
-    if (name !== undefined) {
-      if (!name.trim()) {
-        throw new Error("Goal name must not be empty");
-      }
-      fieldsToUpdate.name = name.trim();
-      updateMask.push("name");
+    const client = this.getGraphQLClient();
+    try {
+      const result = await deleteCategory(client, { id: args.category_id });
+      return { success: true, category_id: result.id, deleted: true };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
     }
-    if (emoji3 !== undefined) {
-      fieldsToUpdate.emoji = emoji3;
-      updateMask.push("emoji");
+  }
+  async setBudget(args) {
+    const client = this.getGraphQLClient();
+    if (!args.category_id?.trim())
+      throw new Error("category_id is required");
+    if (typeof args.amount !== "string") {
+      throw new Error('amount must be a string (e.g. "250.00")');
     }
-    const savingsUpdate = {};
-    if (target_amount !== undefined) {
-      if (target_amount <= 0) {
-        throw new Error("target_amount must be greater than 0");
-      }
-      savingsUpdate.target_amount = target_amount;
+    if (!/^\d+(\.\d{1,2})?$/.test(args.amount)) {
+      throw new Error('amount must be a non-negative decimal like "250.00" or "0" to clear the budget');
     }
-    if (monthly_contribution !== undefined) {
-      if (monthly_contribution < 0) {
-        throw new Error("monthly_contribution must be >= 0");
-      }
-      savingsUpdate.tracking_type_monthly_contribution = monthly_contribution;
+    if (args.month !== undefined && !/^\d{4}-\d{2}$/.test(args.month)) {
+      throw new Error('month must be "YYYY-MM"');
     }
-    if (status !== undefined) {
-      savingsUpdate.status = status;
+    try {
+      const result = await setBudget(client, {
+        categoryId: args.category_id,
+        amount: args.amount,
+        month: args.month
+      });
+      return {
+        success: true,
+        category_id: result.categoryId,
+        amount: result.amount,
+        ...result.month ? { month: result.month } : {},
+        cleared: result.cleared
+      };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
     }
-    if (Object.keys(savingsUpdate).length > 0) {
-      fieldsToUpdate.savings = savingsUpdate;
-      updateMask.push("savings");
+  }
+  async setRecurringState(args) {
+    const client = this.getGraphQLClient();
+    const VALID_STATES = ["ACTIVE", "PAUSED", "ARCHIVED"];
+    if (!VALID_STATES.includes(args.state)) {
+      throw new Error(`state must be one of: ${VALID_STATES.join(", ")}. Got: ${args.state}`);
     }
-    if (updateMask.length === 0) {
-      throw new Error("No fields to update");
+    try {
+      const result = await editRecurring(client, {
+        id: args.recurring_id,
+        input: { state: args.state }
+      });
+      return { success: true, recurring_id: result.id, state: args.state };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
     }
-    const userId = await client.requireUserId();
-    const collectionPath = `users/${userId}/financial_goals`;
-    const firestoreFields = toFirestoreFields(fieldsToUpdate);
-    await client.updateDocument(collectionPath, goal_id, firestoreFields, updateMask);
-    this.db.clearCache();
-    return {
-      success: true,
-      goal_id,
-      updated_fields: updateMask
-    };
   }
-  async deleteGoal(args) {
-    const client = this.getFirestoreClient();
-    const { goal_id } = args;
-    validateDocId(goal_id, "goal_id");
-    const goals = await this.db.getGoals(false);
-    const goal = goals.find((g) => g.goal_id === goal_id);
-    if (!goal) {
-      throw new Error(`Goal not found: ${goal_id}`);
-    }
-    const userId = await client.requireUserId();
-    const collectionPath = `users/${userId}/financial_goals`;
-    await client.deleteDocument(collectionPath, goal_id);
-    this.db.clearCache();
-    return {
-      success: true,
-      goal_id,
-      deleted_name: goal.name ?? goal_id
-    };
+  async deleteRecurring(args) {
+    const client = this.getGraphQLClient();
+    try {
+      const result = await deleteRecurring(client, { id: args.recurring_id });
+      return { success: true, recurring_id: result.id, deleted: true };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
+    }
   }
   async updateTag(args) {
-    const client = this.getFirestoreClient();
-    const { tag_id, name, color_name, hex_color } = args;
-    validateDocId(tag_id, "tag_id");
-    const existingTags = await this.db.getTags();
-    const tag = existingTags.find((t) => t.tag_id === tag_id);
-    if (!tag) {
-      throw new Error(`Tag not found: ${tag_id}`);
-    }
-    const fieldsToUpdate = {};
-    const updateMask = [];
-    if (name !== undefined) {
-      const trimmedName = name.trim();
-      if (!trimmedName) {
-        throw new Error("Tag name must not be empty");
-      }
-      fieldsToUpdate.name = trimmedName;
-      updateMask.push("name");
-    }
-    if (color_name !== undefined) {
-      fieldsToUpdate.color_name = color_name;
-      updateMask.push("color_name");
-    }
-    if (hex_color !== undefined) {
-      validateHexColor(hex_color);
-      fieldsToUpdate.hex_color = hex_color;
-      updateMask.push("hex_color");
-    }
-    if (updateMask.length === 0) {
-      throw new Error("No fields to update. Provide at least one of: name, color_name, hex_color");
-    }
-    const userId = await client.requireUserId();
-    const collectionPath = `users/${userId}/tags`;
-    const firestoreFields = toFirestoreFields(fieldsToUpdate);
-    await client.updateDocument(collectionPath, tag_id, firestoreFields, updateMask);
-    this.db.clearCache();
-    return {
-      success: true,
-      tag_id,
-      updated_fields: updateMask
-    };
+    const client = this.getGraphQLClient();
+    const input = {};
+    if (args.name !== undefined)
+      input.name = args.name;
+    if (args.color_name !== undefined)
+      input.colorName = args.color_name;
+    if (Object.keys(input).length === 0) {
+      throw new Error("update_tag requires at least one field to update");
+    }
+    try {
+      const result = await editTag(client, { id: args.tag_id, input });
+      return { success: true, tag_id: result.id, updated: Object.keys(result.changed) };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
+    }
   }
   async createRecurring(args) {
-    const client = this.getFirestoreClient();
-    const { name, amount, frequency, category_id, account_id, merchant_name, start_date } = args;
-    const trimmedName = name.trim();
-    if (!trimmedName) {
-      throw new Error("Recurring name must not be empty");
-    }
-    if (amount <= 0) {
-      throw new Error("Recurring amount must be greater than 0");
-    }
-    if (!VALID_RECURRING_FREQUENCIES.includes(frequency)) {
-      throw new Error(`Invalid frequency: ${frequency}. Must be one of: ${VALID_RECURRING_FREQUENCIES.join(", ")}`);
-    }
-    if (category_id !== undefined)
-      validateDocId(category_id, "category_id");
-    if (account_id !== undefined)
-      validateDocId(account_id, "account_id");
-    if (start_date !== undefined)
-      validateDate(start_date, "start_date");
-    const recurringId = crypto.randomUUID();
-    const userId = await client.requireUserId();
-    const today = new Date().toISOString().slice(0, 10);
-    const docFields = {
-      recurring_id: recurringId,
-      name: trimmedName,
-      amount,
-      frequency,
-      is_active: true,
-      state: "active",
-      latest_date: start_date ?? today
-    };
-    if (category_id !== undefined)
-      docFields.category_id = category_id;
-    if (account_id !== undefined)
-      docFields.account_id = account_id;
-    if (merchant_name !== undefined)
-      docFields.merchant_name = merchant_name;
-    if (start_date !== undefined)
-      docFields.start_date = start_date;
-    const collectionPath = `users/${userId}/recurring`;
-    const firestoreFields = toFirestoreFields(docFields);
-    await client.createDocument(collectionPath, recurringId, firestoreFields);
-    this.db.clearCache();
-    return {
-      success: true,
-      recurring_id: recurringId,
-      name: trimmedName,
-      amount,
-      frequency
-    };
-  }
-  async createGoal(args) {
-    const client = this.getFirestoreClient();
-    const { name, target_amount, emoji: emoji3, monthly_contribution, start_date } = args;
-    const trimmedName = name.trim();
-    if (!trimmedName) {
-      throw new Error("Goal name must not be empty");
+    const client = this.getGraphQLClient();
+    const VALID_FREQUENCIES = ["WEEKLY", "BIWEEKLY", "MONTHLY", "YEARLY"];
+    if (!VALID_FREQUENCIES.includes(args.frequency)) {
+      throw new Error(`frequency must be one of: ${VALID_FREQUENCIES.join(", ")}. Got: ${args.frequency}`);
     }
-    if (target_amount <= 0) {
-      throw new Error("target_amount must be greater than 0");
+    const all = await this.db.getAllTransactions();
+    const txn = all.find((t) => t.transaction_id === args.transaction_id);
+    if (!txn)
+      throw new Error(`Transaction not found: ${args.transaction_id}`);
+    if (!txn.account_id || !txn.item_id) {
+      throw new Error(`Transaction ${args.transaction_id} missing account_id or item_id in local cache`);
     }
-    if (monthly_contribution !== undefined && monthly_contribution < 0) {
-      throw new Error("monthly_contribution must be >= 0");
+    try {
+      const result = await createRecurring(client, {
+        input: {
+          frequency: args.frequency,
+          transaction: {
+            accountId: txn.account_id,
+            itemId: txn.item_id,
+            transactionId: args.transaction_id
+          }
+        }
+      });
+      return {
+        success: true,
+        recurring_id: result.id,
+        name: result.name,
+        state: result.state,
+        frequency: result.frequency
+      };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
     }
-    if (start_date !== undefined)
-      validateDate(start_date, "start_date");
-    const goalId = crypto.randomUUID();
-    const userId = await client.requireUserId();
-    const today = new Date().toISOString().slice(0, 10);
-    const docFields = {
-      goal_id: goalId,
-      name: trimmedName,
-      savings: {
-        type: "savings",
-        status: "active",
-        target_amount,
-        tracking_type: monthly_contribution !== undefined ? "monthly_contribution" : "manual",
-        tracking_type_monthly_contribution: monthly_contribution ?? 0,
-        start_date: start_date ?? today,
-        is_ongoing: false
-      }
-    };
-    if (emoji3 !== undefined)
-      docFields.emoji = emoji3;
-    const collectionPath = `users/${userId}/financial_goals`;
-    const firestoreFields = toFirestoreFields(docFields);
-    await client.createDocument(collectionPath, goalId, firestoreFields);
-    this.db.clearCache();
-    return {
-      success: true,
-      goal_id: goalId,
-      name: trimmedName,
-      target_amount
-    };
   }
   async updateRecurring(args) {
-    const client = this.getFirestoreClient();
-    const {
-      recurring_id,
-      name,
-      amount,
-      frequency,
-      category_id,
-      account_id,
-      merchant_name,
-      emoji: emoji3,
-      match_string,
-      transaction_ids,
-      excluded_transaction_ids,
-      included_transaction_ids,
-      days_filter
-    } = args;
-    validateDocId(recurring_id, "recurring_id");
-    const allRecurring = await this.db.getRecurring(false);
-    const recurring = allRecurring.find((r) => r.recurring_id === recurring_id);
-    if (!recurring) {
-      throw new Error(`Recurring not found: ${recurring_id}`);
-    }
-    const fieldsToUpdate = {};
-    const updateMask = [];
-    if (name !== undefined) {
-      if (!name.trim()) {
-        throw new Error("Recurring name must not be empty");
-      }
-      fieldsToUpdate.name = name.trim();
-      updateMask.push("name");
-    }
-    if (amount !== undefined) {
-      if (amount <= 0) {
-        throw new Error("amount must be greater than 0");
-      }
-      fieldsToUpdate.amount = amount;
-      updateMask.push("amount");
-    }
-    if (frequency !== undefined) {
-      if (!VALID_RECURRING_FREQUENCIES.includes(frequency)) {
-        throw new Error(`Invalid frequency: ${frequency}. Must be one of: ${VALID_RECURRING_FREQUENCIES.join(", ")}`);
-      }
-      fieldsToUpdate.frequency = frequency;
-      updateMask.push("frequency");
-    }
-    if (category_id !== undefined) {
-      validateDocId(category_id, "category_id");
-      fieldsToUpdate.category_id = category_id;
-      updateMask.push("category_id");
-    }
-    if (account_id !== undefined) {
-      validateDocId(account_id, "account_id");
-      fieldsToUpdate.account_id = account_id;
-      updateMask.push("account_id");
-    }
-    if (merchant_name !== undefined) {
-      fieldsToUpdate.merchant_name = merchant_name;
-      updateMask.push("merchant_name");
-    }
-    if (emoji3 !== undefined) {
-      fieldsToUpdate.emoji = emoji3;
-      updateMask.push("emoji");
-    }
-    if (match_string !== undefined) {
-      if (!match_string.trim()) {
-        throw new Error("match_string must not be empty");
-      }
-      fieldsToUpdate.match_string = match_string.trim();
-      updateMask.push("match_string");
-    }
-    if (transaction_ids !== undefined) {
-      fieldsToUpdate.transaction_ids = transaction_ids;
-      updateMask.push("transaction_ids");
-    }
-    if (excluded_transaction_ids !== undefined) {
-      fieldsToUpdate.excluded_transaction_ids = excluded_transaction_ids;
-      updateMask.push("excluded_transaction_ids");
-    }
-    if (included_transaction_ids !== undefined) {
-      fieldsToUpdate.included_transaction_ids = included_transaction_ids;
-      updateMask.push("included_transaction_ids");
-    }
-    if (days_filter !== undefined) {
-      fieldsToUpdate.days_filter = days_filter;
-      updateMask.push("days_filter");
-    }
-    if (updateMask.length === 0) {
-      throw new Error("No fields to update");
-    }
-    const userId = await client.requireUserId();
-    const collectionPath = `users/${userId}/recurring`;
-    const firestoreFields = toFirestoreFields(fieldsToUpdate);
-    await client.updateDocument(collectionPath, recurring_id, firestoreFields, updateMask);
-    this.db.clearCache();
-    const displayName = name?.trim() ?? recurring.name ?? recurring.merchant_name ?? recurring_id;
-    return {
-      success: true,
-      recurring_id,
-      name: displayName,
-      updated_fields: updateMask
-    };
+    const client = this.getGraphQLClient();
+    const input = {};
+    if (args.state !== undefined)
+      input.state = args.state;
+    if (args.rule !== undefined) {
+      const rule = {};
+      if (args.rule.name_contains !== undefined)
+        rule.nameContains = args.rule.name_contains;
+      if (args.rule.min_amount !== undefined)
+        rule.minAmount = args.rule.min_amount;
+      if (args.rule.max_amount !== undefined)
+        rule.maxAmount = args.rule.max_amount;
+      if (args.rule.days !== undefined)
+        rule.days = args.rule.days;
+      input.rule = rule;
+    }
+    if (Object.keys(input).length === 0) {
+      throw new Error("update_recurring requires at least one field to update");
+    }
+    try {
+      const result = await editRecurring(client, { id: args.recurring_id, input });
+      return { success: true, recurring_id: result.id, updated: Object.keys(result.changed) };
+    } catch (e) {
+      if (e instanceof GraphQLError)
+        throw new Error(graphQLErrorToMcpError(e), { cause: e });
+      throw e;
+    }
   }
   async getBalanceHistory(options) {
     const { account_id, start_date, end_date, granularity } = options;
@@ -34746,7 +34895,7 @@ function createToolSchemas() {
     },
     {
       name: "get_budgets",
-      description: "Get budgets from Copilot's native budget tracking. " + "Retrieves user-defined spending limits and budget rules stored in the app. " + "Returns budget details including amounts, periods (monthly/yearly/weekly), " + "category associations, and active status. Calculates total budgeted amount as monthly equivalent.",
+      description: "Get budgets from Copilot's native budget tracking. " + "Retrieves user-defined spending limits and budget rules stored in the app. " + "Returns budget details including amounts, periods (monthly/yearly/weekly), " + "category associations, and active status. Calculates total budgeted amount as monthly equivalent. " + "Sync note: after `set_budget` writes, budget changes can take significantly longer " + "to reflect in this read than other collections (transactions/tags/categories/recurrings " + "sync in seconds; budgets may take minutes). Do not assume a fresh `set_budget` is " + "immediately observable here — poll with `refresh_database` or verify directly in the " + "Copilot app. Per-month overrides written via `set_budget(month=...)` are not surfaced " + "in this view; only the all-months default `amount` is returned.",
       inputSchema: {
         type: "object",
         properties: {
@@ -34905,7 +35054,7 @@ function createToolSchemas() {
     },
     {
       name: "get_investment_performance",
-      description: "Get per-security investment performance data. Returns structured performance records " + "from Firestore, enriched with ticker symbol and name from the securities collection. " + "Filter by ticker symbol or security ID.",
+      description: "Get per-security investment performance data. Returns structured performance records " + "from the local LevelDB cache, enriched with ticker symbol and name from the securities collection. " + "Filter by ticker symbol or security ID.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35033,7 +35182,7 @@ function createWriteToolSchemas() {
   return [
     {
       name: "update_transaction",
-      description: "Update one or more fields on a transaction in a single atomic write. " + "Pass transaction_id plus any combination of category_id, note, tag_ids, " + "excluded, name, internal_transfer, or goal_id. Omitted fields are preserved " + '(e.g., sending only tag_ids does not erase the note). Pass note="" to clear ' + "the note. Pass tag_ids=[] to clear all tags. Pass goal_id=null to unlink the " + "goal. At least one mutable field must be provided besides transaction_id.",
+      description: "Update a single transaction's category, note, or tags. Pass transaction_id plus " + "any combination of category_id, note, or tag_ids — only specified fields are changed. " + 'Pass note="" to clear the note. Pass tag_ids=[] to clear all tags. At least one mutable ' + "field must be provided besides transaction_id. Other fields (name, excluded, " + "internal_transfer, goal_id) are not writable through the GraphQL API and were removed " + "from this tool when the backend was migrated.",
       inputSchema: {
         type: "object",
         additionalProperties: false,
@@ -35054,22 +35203,6 @@ function createWriteToolSchemas() {
             type: "array",
             items: { type: "string" },
             description: "Tag IDs to set. Pass empty array to clear all tags."
-          },
-          excluded: {
-            type: "boolean",
-            description: "Whether the transaction is excluded from spending reports."
-          },
-          name: {
-            type: "string",
-            description: "Display name (will be trimmed; must be non-empty if present)."
-          },
-          internal_transfer: {
-            type: "boolean",
-            description: "Whether the transaction is an internal transfer."
-          },
-          goal_id: {
-            type: ["string", "null"],
-            description: "Financial goal ID to link to. Pass null to unlink the existing goal."
           }
         },
         required: ["transaction_id"]
@@ -35082,7 +35215,7 @@ function createWriteToolSchemas() {
     },
     {
       name: "review_transactions",
-      description: "Mark one or more transactions as reviewed (or unreviewed). " + "Accepts an array of transaction_ids. Writes directly to Copilot Money via Firestore.",
+      description: "Mark one or more transactions as reviewed (or unreviewed). " + "Accepts an array of transaction_ids. Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35106,7 +35239,7 @@ function createWriteToolSchemas() {
     },
     {
       name: "create_tag",
-      description: "Create a new user-defined tag for categorizing transactions. Tags appear in the " + "Copilot Money app and are stored in the tag_ids field on transactions. " + "Optionally set a color. Writes directly to Copilot Money via Firestore.",
+      description: "Create a new user-defined tag for categorizing transactions. Tags appear in the " + "Copilot Money app and are stored in the tag_ids field on transactions. " + "Optionally set a color. Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35133,7 +35266,7 @@ function createWriteToolSchemas() {
     },
     {
       name: "delete_tag",
-      description: "Delete a user-defined tag. The tag_id can be obtained from the tag definitions " + "in the local cache. Writes directly to Copilot Money via Firestore.",
+      description: "Delete a user-defined tag. The tag_id can be obtained from the tag definitions " + "in the local cache. Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35152,7 +35285,7 @@ function createWriteToolSchemas() {
     },
     {
       name: "create_category",
-      description: "Create a new custom category in Copilot Money. Provide a name (required) " + "and optionally an emoji, color, parent category, or excluded flag. " + "Returns the generated category_id. The new category can then be used " + "with update_transaction.",
+      description: "Create a new custom category in Copilot Money. Provide name, color_name, " + "and emoji (all required). Optionally set is_excluded. Returns the generated " + "category_id. The new category can then be used with update_transaction. " + "Note: parent/child category hierarchies are not writable through Copilot's " + "GraphQL API — create flat categories only. Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35160,25 +35293,22 @@ function createWriteToolSchemas() {
             type: "string",
             description: 'Display name for the new category (e.g., "Subscriptions")'
           },
-          emoji: {
-            type: "string",
-            description: 'Emoji icon for the category (e.g., "\uD83C\uDFAC")'
-          },
-          color: {
+          color_name: {
             type: "string",
-            description: 'Hex color code for the category (e.g., "#FF5733")'
+            description: 'Named color from the Copilot palette (e.g., "RED1", "OLIVE1", "PURPLE2"). ' + "See existing categories via get_categories for valid values."
           },
-          parent_category_id: {
+          emoji: {
             type: "string",
-            description: "Parent category ID to nest under (from get_categories). " + "Creates a subcategory when provided."
+            description: 'Emoji icon for the category (e.g., "\uD83C\uDFAC")'
           },
-          excluded: {
+          is_excluded: {
             type: "boolean",
             description: "Exclude this category from spending totals (default: false)",
             default: false
           }
         },
-        required: ["name"]
+        required: ["name", "color_name", "emoji"],
+        additionalProperties: false
       },
       annotations: {
         readOnlyHint: false,
@@ -35188,7 +35318,7 @@ function createWriteToolSchemas() {
     },
     {
       name: "update_category",
-      description: "Update an existing user-defined category. Provide category_id (required) and any " + "fields to change: name, emoji, color, excluded, or parent_category_id (null to ungroup). " + "Only the specified fields are updated. Writes directly to Copilot Money via Firestore.",
+      description: "Update an existing user-defined category. Provide category_id (required) and any " + "fields to change: name, emoji, color_name, or is_excluded. Only the specified " + "fields are updated. Note: parent/child category hierarchies are not writable " + "through Copilot's GraphQL API. Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35204,20 +35334,17 @@ function createWriteToolSchemas() {
             type: "string",
             description: 'New emoji icon for the category (e.g., "\uD83C\uDFAC")'
           },
-          color: {
+          color_name: {
             type: "string",
-            description: 'New hex color code for the category (e.g., "#FF5733")'
+            description: 'New named color from the Copilot palette (e.g., "RED1", "OLIVE1", "PURPLE2").'
           },
-          excluded: {
+          is_excluded: {
             type: "boolean",
             description: "Exclude this category from spending totals"
-          },
-          parent_category_id: {
-            type: ["string", "null"],
-            description: "Parent category ID to nest under, or null to ungroup. " + "Use get_categories to find valid parent IDs."
           }
         },
-        required: ["category_id"]
+        required: ["category_id"],
+        additionalProperties: false
       },
       annotations: {
         readOnlyHint: false,
@@ -35227,7 +35354,7 @@ function createWriteToolSchemas() {
     },
     {
       name: "delete_category",
-      description: "Delete a user-defined category. The category_id can be obtained from get_categories. " + "Writes directly to Copilot Money via Firestore.",
+      description: "Delete a user-defined category. The category_id can be obtained from get_categories. " + "Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35245,66 +35372,26 @@ function createWriteToolSchemas() {
       }
     },
     {
-      name: "create_budget",
-      description: "Create a new budget in Copilot Money. Requires a category_id and amount. " + "Only one budget per category is allowed. Optionally set a period (default: monthly) " + "and a display name. Writes directly to Copilot Money via Firestore.",
+      name: "set_budget",
+      description: 'Set the monthly budget amount for a category. amount="0" clears the budget. ' + 'Pass month="YYYY-MM" for a single-month override; omit for the all-months default. ' + 'Note: if the user has disabled "Enable budgeting" or "Enable rollover" in ' + "Copilot → Settings → General, the budget write still succeeds on the server, but " + "the value will not appear in the Copilot UI until those toggles are re-enabled. " + 'Rollover behavior also depends on the "Rollover categories" selection in the same ' + "settings pane, which is not writable through this tool. " + "Sync delay: successful writes may not be visible via `get_budgets` for minutes — " + "budget docs sync on a slower cadence than other collections. Do not retry the write " + "just because the read does not reflect it yet.",
       inputSchema: {
         type: "object",
         properties: {
           category_id: {
             type: "string",
-            description: "Category ID to budget for (from get_categories)"
+            description: "ID of the category to budget."
           },
           amount: {
-            type: "number",
-            description: "Budget amount (must be greater than 0)"
-          },
-          period: {
             type: "string",
-            description: "Budget period: monthly, yearly, weekly, or daily (default: monthly)",
-            enum: ["monthly", "yearly", "weekly", "daily"]
+            description: 'Decimal amount as a string (e.g. "250.00"). "0" clears the budget.'
           },
-          name: {
+          month: {
             type: "string",
-            description: "Optional display name for the budget"
+            description: "Optional. YYYY-MM for a single-month override. Omit to set the all-months default."
           }
         },
-        required: ["category_id", "amount"]
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: false
-      }
-    },
-    {
-      name: "update_budget",
-      description: "Update an existing budget in Copilot Money. Requires budget_id and at least one " + "field to update (amount, period, name, or is_active). Only provided fields are changed.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          budget_id: {
-            type: "string",
-            description: "Budget ID to update (from get_budgets)"
-          },
-          amount: {
-            type: "number",
-            description: "New budget amount (must be greater than 0)"
-          },
-          period: {
-            type: "string",
-            description: "New budget period: monthly, yearly, weekly, or daily",
-            enum: ["monthly", "yearly", "weekly", "daily"]
-          },
-          name: {
-            type: "string",
-            description: "New display name for the budget"
-          },
-          is_active: {
-            type: "boolean",
-            description: "Set to false to deactivate the budget, true to reactivate"
-          }
-        },
-        required: ["budget_id"]
+        required: ["category_id", "amount"],
+        additionalProperties: false
       },
       annotations: {
         readOnlyHint: false,
@@ -35312,28 +35399,9 @@ function createWriteToolSchemas() {
         idempotentHint: true
       }
     },
-    {
-      name: "delete_budget",
-      description: "Delete a budget from Copilot Money. Requires the budget_id (from get_budgets). " + "This permanently removes the budget. Writes directly to Copilot Money via Firestore.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          budget_id: {
-            type: "string",
-            description: "Budget ID to delete (from get_budgets)"
-          }
-        },
-        required: ["budget_id"]
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: true,
-        idempotentHint: true
-      }
-    },
     {
       name: "set_recurring_state",
-      description: "Change the state of a recurring item (subscription/charge). " + "Set to active, paused, or archived. Requires recurring_id (from get_recurring_transactions). " + "Writes directly to Copilot Money via Firestore.",
+      description: "Change the state of a recurring item (subscription/charge). " + "Set to ACTIVE, PAUSED, or ARCHIVED (uppercase, matching the GraphQL API). " + "Requires recurring_id (from get_recurring_transactions). " + "Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35343,8 +35411,8 @@ function createWriteToolSchemas() {
           },
           state: {
             type: "string",
-            enum: ["active", "paused", "archived"],
-            description: "New state for the recurring item"
+            enum: ["ACTIVE", "PAUSED", "ARCHIVED"],
+            description: "New state for the recurring item (uppercase: ACTIVE, PAUSED, ARCHIVED)"
           }
         },
         required: ["recurring_id", "state"]
@@ -35357,7 +35425,7 @@ function createWriteToolSchemas() {
     },
     {
       name: "delete_recurring",
-      description: "Delete a recurring item (subscription/charge). " + "Requires recurring_id (from get_recurring_transactions). " + "Writes directly to Copilot Money via Firestore.",
+      description: "Delete a recurring item (subscription/charge). " + "Requires recurring_id (from get_recurring_transactions). " + "Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35374,68 +35442,9 @@ function createWriteToolSchemas() {
         idempotentHint: true
       }
     },
-    {
-      name: "update_goal",
-      description: "Update a financial goal's properties. Provide goal_id (required) and any combination " + "of name, emoji, target_amount, monthly_contribution, or status. Only the fields you " + "provide will be updated. Writes directly to Copilot Money via Firestore.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          goal_id: {
-            type: "string",
-            description: "Goal ID to update (from get_goals results)"
-          },
-          name: {
-            type: "string",
-            description: "New display name for the goal"
-          },
-          emoji: {
-            type: "string",
-            description: "New emoji icon for the goal"
-          },
-          target_amount: {
-            type: "number",
-            description: "New target savings amount (must be > 0)"
-          },
-          monthly_contribution: {
-            type: "number",
-            description: "New monthly contribution amount (must be >= 0)"
-          },
-          status: {
-            type: "string",
-            enum: ["active", "paused"],
-            description: "Set goal status to active or paused"
-          }
-        },
-        required: ["goal_id"]
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: true
-      }
-    },
-    {
-      name: "delete_goal",
-      description: "Delete a financial goal. The goal_id can be obtained from get_goals results. " + "Writes directly to Copilot Money via Firestore.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          goal_id: {
-            type: "string",
-            description: "Goal ID to delete"
-          }
-        },
-        required: ["goal_id"]
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: true,
-        idempotentHint: true
-      }
-    },
     {
       name: "update_tag",
-      description: "Update an existing tag. Provide tag_id (required) and at least one of name, " + "color_name, or hex_color. Only the specified fields are updated. " + "Writes directly to Copilot Money via Firestore.",
+      description: "Update an existing tag. Provide tag_id (required) and at least one of name, " + "color_name, or hex_color. Only the specified fields are updated. " + "Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
@@ -35466,76 +35475,22 @@ function createWriteToolSchemas() {
     },
     {
       name: "create_recurring",
-      description: "Create a new recurring/subscription item. Requires a name, amount, and frequency. " + "Optionally set category, account, merchant name, or start date. " + "Writes directly to Copilot Money via Firestore.",
+      description: "Create a new recurring/subscription item by seeding it from an existing transaction. " + "The recurring inherits its merchant name, account, and initial amount from that transaction; " + "you only supply the cadence (frequency). Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
-          name: {
+          transaction_id: {
             type: "string",
-            description: 'Name of the recurring item (e.g. "Netflix", "Gym Membership")'
-          },
-          amount: {
-            type: "number",
-            description: "Recurring amount (must be greater than 0)"
+            description: "ID of an existing transaction to seed the recurring from. The recurring inherits its merchant name, account, and initial amount from this transaction."
           },
           frequency: {
             type: "string",
-            enum: ["weekly", "biweekly", "monthly", "yearly"],
-            description: "How often the charge recurs"
-          },
-          category_id: {
-            type: "string",
-            description: "Category ID for this recurring item (from get_categories)"
-          },
-          account_id: {
-            type: "string",
-            description: "Account ID for this recurring item (from get_accounts)"
-          },
-          merchant_name: {
-            type: "string",
-            description: "Merchant name for the recurring charge"
-          },
-          start_date: {
-            type: "string",
-            description: "Start date in ISO format (YYYY-MM-DD). Defaults to today."
-          }
-        },
-        required: ["name", "amount", "frequency"]
-      },
-      annotations: {
-        readOnlyHint: false,
-        destructiveHint: false,
-        idempotentHint: false
-      }
-    },
-    {
-      name: "create_goal",
-      description: "Create a new financial goal. Requires a name and target amount. " + "Optionally set an emoji, monthly contribution, or start date. " + "Writes directly to Copilot Money via Firestore.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          name: {
-            type: "string",
-            description: 'Name of the financial goal (e.g. "Emergency Fund", "Vacation")'
-          },
-          target_amount: {
-            type: "number",
-            description: "Target savings amount (must be greater than 0)"
-          },
-          emoji: {
-            type: "string",
-            description: 'Emoji icon for the goal (e.g. "\uD83C\uDFD6️")'
-          },
-          monthly_contribution: {
-            type: "number",
-            description: "Monthly contribution amount (must be >= 0). " + "Sets tracking to monthly_contribution mode when provided."
-          },
-          start_date: {
-            type: "string",
-            description: "Start date in ISO format (YYYY-MM-DD). Defaults to today."
+            enum: ["WEEKLY", "BIWEEKLY", "MONTHLY", "YEARLY"],
+            description: "How often the recurring payment occurs."
           }
         },
-        required: ["name", "target_amount"]
+        required: ["transaction_id", "frequency"],
+        additionalProperties: false
       },
       annotations: {
         readOnlyHint: false,
@@ -35545,68 +35500,46 @@ function createWriteToolSchemas() {
     },
     {
       name: "update_recurring",
-      description: "Update an existing recurring/subscription item. Can modify name, amount, frequency, " + "category, account, match string, and transaction ID lists. " + "Useful for fixing recurring detection — update match_string and transaction_ids " + "to teach Copilot which transactions belong to this recurring charge. " + "Writes directly to Copilot Money via Firestore.",
+      description: "Update an existing recurring transaction. Pass recurring_id plus any combination of " + "state or rule (name_contains, min_amount, max_amount, days). The recurring cannot be " + "renamed or re-linked to a different transaction through this tool — those fields must " + "be changed in the Copilot Money web app. Writes directly to Copilot Money via GraphQL.",
       inputSchema: {
         type: "object",
         properties: {
           recurring_id: {
             type: "string",
-            description: "ID of the recurring item to update (from get_recurring_transactions)"
-          },
-          name: {
-            type: "string",
-            description: "New display name for the recurring charge"
-          },
-          amount: {
-            type: "number",
-            description: "Expected recurring amount (must be > 0)"
-          },
-          frequency: {
-            type: "string",
-            enum: ["weekly", "biweekly", "monthly", "yearly"],
-            description: "How often this charge recurs"
-          },
-          category_id: {
-            type: "string",
-            description: "Category ID to assign (from get_categories)"
-          },
-          account_id: {
-            type: "string",
-            description: "Account ID this recurring charge is associated with"
-          },
-          merchant_name: {
-            type: "string",
-            description: "Merchant name for the recurring charge"
-          },
-          emoji: {
-            type: "string",
-            description: "Emoji icon for the recurring item"
+            description: "ID of the recurring to update."
           },
-          match_string: {
+          state: {
             type: "string",
-            description: "Pattern used to auto-match incoming transactions to this recurring item " + '(e.g., "NETFLIX" matches transactions with "NETFLIX" in the name)'
-          },
-          transaction_ids: {
-            type: "array",
-            items: { type: "string" },
-            description: "Transaction IDs that belong to this recurring item"
-          },
-          excluded_transaction_ids: {
-            type: "array",
-            items: { type: "string" },
-            description: "Transaction IDs explicitly excluded from this recurring item"
-          },
-          included_transaction_ids: {
-            type: "array",
-            items: { type: "string" },
-            description: "Transaction IDs explicitly included in this recurring item"
+            enum: ["ACTIVE", "PAUSED", "ARCHIVED"],
+            description: "State of the recurring. Use set_recurring_state instead if you only want to " + "change state — this tool is for broader edits."
           },
-          days_filter: {
-            type: "number",
-            description: "Expected day-of-month for matching (e.g., 1 for charges on the 1st)"
+          rule: {
+            type: "object",
+            description: "Matching rule. Controls how Copilot auto-detects future payments.",
+            properties: {
+              name_contains: {
+                type: "string",
+                description: "Substring that must appear in the merchant/payee name."
+              },
+              min_amount: {
+                type: "string",
+                description: "Minimum amount (as a decimal string) for a transaction to match."
+              },
+              max_amount: {
+                type: "string",
+                description: "Maximum amount (as a decimal string) for a transaction to match."
+              },
+              days: {
+                type: "array",
+                items: { type: "number" },
+                description: "Days of the month (1-31) when this recurring is expected."
+              }
+            },
+            additionalProperties: false
           }
         },
-        required: ["recurring_id"]
+        required: ["recurring_id"],
+        additionalProperties: false
       },
       annotations: {
         readOnlyHint: false,
@@ -35616,100 +35549,6 @@ function createWriteToolSchemas() {
     }
   ];
 }
-// src/core/firestore-client.ts
-var FIRESTORE_PROJECT_ID = "copilot-production-22904";
-var FIRESTORE_BASE_URL = "https://firestore.googleapis.com/v1";
-
-class FirestoreClient {
-  auth;
-  constructor(auth) {
-    this.auth = auth;
-  }
-  getUserId() {
-    return this.auth.getUserId();
-  }
-  async requireUserId() {
-    await this.auth.getIdToken();
-    const uid = this.auth.getUserId();
-    if (!uid) {
-      throw new Error("Firebase user ID unavailable after authentication");
-    }
-    return uid;
-  }
-  async updateDocument(collectionPath, documentId, fields, updateMask) {
-    const idToken = await this.auth.getIdToken();
-    const docPath = `projects/${FIRESTORE_PROJECT_ID}/databases/(default)/documents/${collectionPath}/${documentId}`;
-    const url2 = new URL(`${FIRESTORE_BASE_URL}/${docPath}`);
-    for (const field of updateMask) {
-      url2.searchParams.append("updateMask.fieldPaths", field);
-    }
-    const response = await fetch(url2.toString(), {
-      method: "PATCH",
-      headers: {
-        Authorization: `Bearer ${idToken}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({ fields })
-    });
-    if (!response.ok) {
-      const errorBody = await response.text();
-      throw new Error(`Firestore update failed (${response.status}): ${errorBody}`);
-    }
-  }
-  async getDocument(collectionPath, documentId) {
-    const idToken = await this.auth.getIdToken();
-    const docPath = `projects/${FIRESTORE_PROJECT_ID}/databases/(default)/documents/${collectionPath}/${documentId}`;
-    const response = await fetch(`${FIRESTORE_BASE_URL}/${docPath}`, {
-      method: "GET",
-      headers: {
-        Authorization: `Bearer ${idToken}`
-      }
-    });
-    if (!response.ok) {
-      const errorBody = await response.text();
-      throw new Error(`Firestore get failed (${response.status}): ${errorBody}`);
-    }
-    const doc2 = await response.json();
-    return doc2.fields ?? {};
-  }
-  async createDocument(collectionPath, documentId, fields) {
-    const idToken = await this.auth.getIdToken();
-    const parentPath = `projects/${FIRESTORE_PROJECT_ID}/databases/(default)/documents`;
-    const url2 = new URL(`${FIRESTORE_BASE_URL}/${parentPath}/${collectionPath}`);
-    if (documentId) {
-      url2.searchParams.set("documentId", documentId);
-    }
-    const response = await fetch(url2.toString(), {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${idToken}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({ fields })
-    });
-    if (!response.ok) {
-      const errorBody = await response.text();
-      throw new Error(`Firestore create failed (${response.status}): ${errorBody}`);
-    }
-    const doc2 = await response.json();
-    return doc2.name.split("/").pop();
-  }
-  async deleteDocument(collectionPath, documentId) {
-    const idToken = await this.auth.getIdToken();
-    const docPath = `projects/${FIRESTORE_PROJECT_ID}/databases/(default)/documents/${collectionPath}/${documentId}`;
-    const response = await fetch(`${FIRESTORE_BASE_URL}/${docPath}`, {
-      method: "DELETE",
-      headers: {
-        Authorization: `Bearer ${idToken}`
-      }
-    });
-    if (!response.ok) {
-      const errorBody = await response.text();
-      throw new Error(`Firestore delete failed (${response.status}): ${errorBody}`);
-    }
-  }
-}
-
 // src/core/auth/firebase-auth.ts
 var FIREBASE_API_KEY = "AIzaSyAMgjkeOSkHj4J4rlswOkD16N3WQOoNPpk";
 var TOKEN_ENDPOINT = `https://securetoken.googleapis.com/v1/token?key=${FIREBASE_API_KEY}`;
@@ -35918,12 +35757,12 @@ class CopilotMoneyServer {
   constructor(dbPath, decodeTimeoutMs, writeEnabled = false) {
     this.db = new CopilotDatabase(dbPath, decodeTimeoutMs);
     this.writeEnabled = writeEnabled;
-    let firestoreClient;
+    let graphqlClient;
     if (writeEnabled) {
       const auth = new FirebaseAuth(() => extractRefreshToken());
-      firestoreClient = new FirestoreClient(auth);
+      graphqlClient = new GraphQLClient(auth);
     }
-    this.tools = new CopilotMoneyTools(this.db, firestoreClient);
+    this.tools = new CopilotMoneyTools(this.db, graphqlClient);
     this.server = new Server({
       name: "copilot-money-mcp",
       version: SERVER_VERSION
@@ -35949,21 +35788,16 @@ class CopilotMoneyServer {
     "update_transaction",
     "review_transactions",
     "create_tag",
+    "update_tag",
     "delete_tag",
     "create_category",
     "update_category",
     "delete_category",
-    "create_budget",
-    "update_budget",
-    "delete_budget",
+    "set_budget",
     "set_recurring_state",
-    "delete_recurring",
-    "update_goal",
-    "delete_goal",
-    "update_tag",
     "create_recurring",
-    "create_goal",
-    "update_recurring"
+    "update_recurring",
+    "delete_recurring"
   ]);
   async handleCallTool(name, typedArgs) {
     if (CopilotMoneyServer.WRITE_TOOLS.has(name) && !this.writeEnabled) {
@@ -36062,14 +35896,8 @@ class CopilotMoneyServer {
         case "delete_category":
           result = await this.tools.deleteCategory(typedArgs);
           break;
-        case "create_budget":
-          result = await this.tools.createBudget(typedArgs);
-          break;
-        case "update_budget":
-          result = await this.tools.updateBudget(typedArgs);
-          break;
-        case "delete_budget":
-          result = await this.tools.deleteBudget(typedArgs);
+        case "set_budget":
+          result = await this.tools.setBudget(typedArgs);
           break;
         case "set_recurring_state":
           result = await this.tools.setRecurringState(typedArgs);
@@ -36077,21 +35905,12 @@ class CopilotMoneyServer {
         case "delete_recurring":
           result = await this.tools.deleteRecurring(typedArgs);
           break;
-        case "update_goal":
-          result = await this.tools.updateGoal(typedArgs);
-          break;
-        case "delete_goal":
-          result = await this.tools.deleteGoal(typedArgs);
-          break;
         case "update_tag":
           result = await this.tools.updateTag(typedArgs);
           break;
         case "create_recurring":
           result = await this.tools.createRecurring(typedArgs);
           break;
-        case "create_goal":
-          result = await this.tools.createGoal(typedArgs);
-          break;
         case "update_recurring":
           result = await this.tools.updateRecurring(typedArgs);
           break;