@infamousendeavors/lunchmoney-mcp 0.3.0

package/dist/types/index.d.ts

@@ -0,0 +1,164 @@
+export interface User {
+    id: number;
+    email: string;
+    name: string;
+    currency: string;
+    budget_display_order?: number[];
+    date_format?: string;
+    first_day_of_week?: number;
+    beta_user?: boolean;
+    created_at?: string;
+}
+export interface Category {
+    id: number;
+    name: string;
+    description?: string;
+    is_income?: boolean;
+    exclude_budget?: boolean;
+    exclude_from_totals?: boolean;
+    archived?: boolean;
+    category_group_id?: number;
+    category_group_name?: string;
+    parent_category_id?: number;
+    parent_category_name?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface CategoryGroup {
+    id: number;
+    name: string;
+    created_at?: string;
+}
+export interface Tag {
+    id: number;
+    name: string;
+    created_at?: string;
+}
+export interface Transaction {
+    id: number;
+    date: string;
+    payee?: string;
+    amount: string;
+    currency: string;
+    notes?: string;
+    category_id?: number;
+    category_name?: string;
+    parent_category_id?: number;
+    parent_category_name?: string;
+    account_id: number;
+    account_name?: string;
+    tags?: Tag[];
+    status?: "cleared" | "uncleared" | "recurring" | "recurring_suggested";
+    is_group?: boolean;
+    group_id?: number;
+    external_id?: string;
+    original_name?: string;
+    type?: "expense" | "income" | "transfer";
+    subtransactions?: Transaction[];
+    plaid_account_id?: number;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface TransactionFilter {
+    start_date?: string;
+    end_date?: string;
+    category_id?: number;
+    tag_id?: number;
+    account_id?: number;
+    debit_as_negative?: boolean;
+    pending?: boolean;
+    status?: "cleared" | "uncleared" | "recurring" | "recurring_suggested";
+    offset?: number;
+    limit?: number;
+}
+export interface RecurringItem {
+    id: number;
+    payee?: string;
+    amount: string;
+    currency: string;
+    category_id?: number;
+    category_name?: string;
+    notes?: string;
+    account_id?: number;
+    account_name?: string;
+    tag_id?: number;
+    tag_name?: string;
+    frequency?: string;
+    flow?: "inflow" | "outflow";
+    start_date?: string;
+    end_date?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface Budget {
+    id: number;
+    category_id?: number;
+    category_name?: string;
+    amount: string;
+    currency: string;
+    start_date: string;
+    end_date: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface Asset {
+    id: number;
+    type_name: string;
+    type_name_override?: string;
+    name: string;
+    balance: string;
+    balance_as_of?: string;
+    currency: string;
+    institution_name?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface APIResponse<T> {
+    [key: string]: T | unknown;
+}
+export interface CategoriesResponse {
+    categories: Category[];
+    category_groups?: CategoryGroup[];
+}
+export interface TransactionsResponse {
+    transactions: Transaction[];
+}
+export interface TagsResponse {
+    tags: Tag[];
+}
+export interface RecurringItemsResponse {
+    recurring_items: RecurringItem[];
+}
+export interface BudgetsResponse {
+    budgets: Budget[];
+}
+export interface AssetsResponse {
+    assets: Asset[];
+}
+export interface PlaidAccount {
+    id: number;
+    date_linked: string;
+    name: string;
+    display_name?: string;
+    type: string;
+    subtype: string;
+    mask: string;
+    institution_name: string;
+    status: string;
+    balance: string;
+    currency: string;
+    balance_last_update: string;
+    limit?: number;
+    plaid_item_id?: number;
+    linked_by_name?: string;
+    allow_transaction_modifications?: boolean;
+    to_base?: number;
+    import_start_date?: string;
+    last_import?: string;
+    last_fetch?: string;
+    plaid_last_successful_update?: string;
+}
+export interface PlaidAccountsResponse {
+    plaid_accounts: PlaidAccount[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,IAAI;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,qBAAqB,CAAC;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACzC,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,qBAAqB,CAAC;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,KAAK;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACjC,YAAY,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,GAAG,EAAE,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACnC,eAAe,EAAE,aAAa,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,KAAK,EAAE,CAAC;CACnB;AAGD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IAClC,cAAc,EAAE,YAAY,EAAE,CAAC;CAClC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class LunchMoneyAPIError extends Error {
+    statusCode?: number | undefined;
+    response?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: unknown | undefined);
+}
+export declare function handleAPIError(error: unknown): never;
+export declare function formatErrorForMCP(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;IAG9B,UAAU,CAAC,EAAE,MAAM;IACnB,QAAQ,CAAC,EAAE,OAAO;gBAFzB,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,OAAO,YAAA;CAKhC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAUpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUxD"}

package/dist/utils/errors.js

@@ -0,0 +1,29 @@
+export class LunchMoneyAPIError extends Error {
+    statusCode;
+    response;
+    constructor(message, statusCode, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = "LunchMoneyAPIError";
+    }
+}
+export function handleAPIError(error) {
+    if (error instanceof LunchMoneyAPIError) {
+        throw error;
+    }
+    if (error instanceof Error) {
+        throw new LunchMoneyAPIError(error.message);
+    }
+    throw new LunchMoneyAPIError("Unknown error occurred");
+}
+export function formatErrorForMCP(error) {
+    if (error instanceof LunchMoneyAPIError) {
+        return `Lunch Money API Error: ${error.message}${error.statusCode ? ` (Status: ${error.statusCode})` : ""}`;
+    }
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    return "An unknown error occurred";
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAG9B;IACA;IAHX,YACI,OAAe,EACR,UAAmB,EACnB,QAAkB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAU;QAGzB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACtC,MAAM,KAAK,CAAC;IAChB,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACtC,OAAO,0BAA0B,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChH,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,2BAA2B,CAAC;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@infamousendeavors/lunchmoney-mcp",
+  "version": "0.3.0",
+  "description": "The definitive MCP server for Lunch Money — local (stdio) and remote (HTTP) with secure credential storage",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "lunchmoney-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "mcp",
+    "lunch-money",
+    "lunchmoney",
+    "finance",
+    "budgeting",
+    "api",
+    "claude",
+    "ai"
+  ],
+  "author": "Joe Garcia <joe@joe-garcia.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/infamousendeavors/lunchmoney-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/infamousendeavors/lunchmoney-mcp/issues"
+  },
+  "homepage": "https://lunchmoney.infamousendeavors.com",
+  "dependencies": {
+    "dotenv": "17.4.2",
+    "env-paths": "4.0.0",
+    "fastmcp": "3.35.0",
+    "keytar": "7.9.0",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.0",
+    "@vitest/coverage-v8": "4.1.6",
+    "tsx": "4.22.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.6"
+  }
+}