tripletex-mcp-server 1.0.0

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { TripletexClient } from "./tripletex-client.js";
+const server = new McpServer({ name: "tripletex-mcp-server", version: "1.0.0" });
+function getClient() {
+    const token = process.env.TRIPLETEX_SESSION_TOKEN;
+    if (!token)
+        throw new Error("TRIPLETEX_SESSION_TOKEN is required. Create one at tripletex.no → Company settings → API access.");
+    return new TripletexClient(token);
+}
+function json(data) { return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; }
+server.tool("list_invoices", "List invoices.", { invoiceDateFrom: z.string().optional(), invoiceDateTo: z.string().optional(), count: z.string().optional() }, async (p) => json(await getClient().listInvoices(p)));
+server.tool("get_invoice", "Get invoice details.", { id: z.string() }, async ({ id }) => json(await getClient().getInvoice(id)));
+server.tool("send_invoice", "Send invoice via email.", { id: z.string(), sendType: z.string().optional().describe("EMAIL or EHF") }, async ({ id, sendType }) => json(await getClient().sendInvoice(id, sendType)));
+server.tool("list_customers", "Search customers.", { name: z.string().optional(), count: z.string().optional() }, async (p) => json(await getClient().listCustomers(p)));
+server.tool("get_customer", "Get customer details.", { id: z.string() }, async ({ id }) => json(await getClient().getCustomer(id)));
+server.tool("create_customer", "Create a customer.", {
+    name: z.string(), email: z.string().optional(), organizationNumber: z.string().optional(), phone: z.string().optional(),
+    address: z.string().optional(), postalCode: z.string().optional(), city: z.string().optional(),
+}, async ({ name, email, organizationNumber, phone, address, postalCode, city }) => json(await getClient().createCustomer({ name, email, organizationNumber, phoneNumber: phone, postalAddress: address ? { addressLine1: address, postalCode, city } : undefined })));
+server.tool("list_suppliers", "List suppliers.", { count: z.string().optional() }, async (p) => json(await getClient().listSuppliers(p)));
+server.tool("list_supplier_invoices", "List supplier invoices.", { invoiceDateFrom: z.string().optional(), count: z.string().optional() }, async (p) => json(await getClient().listSupplierInvoices(p)));
+server.tool("list_ledger_entries", "List ledger postings.", { dateFrom: z.string().optional(), dateTo: z.string().optional(), count: z.string().optional() }, async (p) => json(await getClient().listLedgerEntries(p)));
+server.tool("create_voucher", "Create a journal voucher.", {
+    date: z.string(), description: z.string().optional(),
+    postings: z.array(z.object({ accountId: z.number(), amount: z.number(), description: z.string().optional() })),
+}, async ({ date, description, postings }) => json(await getClient().createVoucher({ date, description, postings: postings.map(p => ({ account: { id: p.accountId }, amount: p.amount, description: p.description })) })));
+server.tool("list_accounts", "Get chart of accounts.", { count: z.string().optional() }, async (p) => json(await getClient().listAccounts(p)));
+server.tool("list_projects", "List projects.", { count: z.string().optional() }, async (p) => json(await getClient().listProjects(p)));
+server.tool("list_employees", "List employees.", { count: z.string().optional() }, async (p) => json(await getClient().listEmployees(p)));
+server.tool("list_products", "List products.", { count: z.string().optional() }, async (p) => json(await getClient().listProducts(p)));
+server.tool("get_company_info", "Get company info.", {}, async () => json(await getClient().getCompany()));
+async function main() { await server.connect(new StdioServerTransport()); }
+main().catch((e) => { console.error("Server error:", e); process.exit(1); });

package/dist/tripletex-client.d.ts

@@ -0,0 +1,83 @@
+export declare class TripletexClient {
+    private sessionToken;
+    constructor(sessionToken: string);
+    private request;
+    listInvoices(params?: {
+        invoiceDateFrom?: string;
+        invoiceDateTo?: string;
+        from?: string;
+        count?: string;
+    }): Promise<unknown>;
+    getInvoice(id: string): Promise<unknown>;
+    createInvoice(invoice: {
+        invoiceDate: string;
+        invoiceDueDate: string;
+        orders: Array<{
+            id: number;
+        }>;
+    }): Promise<unknown>;
+    sendInvoice(id: string, sendType?: string): Promise<unknown>;
+    listCustomers(params?: {
+        name?: string;
+        from?: string;
+        count?: string;
+    }): Promise<unknown>;
+    getCustomer(id: string): Promise<unknown>;
+    createCustomer(c: {
+        name: string;
+        email?: string;
+        organizationNumber?: string;
+        phoneNumber?: string;
+        postalAddress?: {
+            addressLine1?: string;
+            postalCode?: string;
+            city?: string;
+            country?: {
+                id?: number;
+            };
+        };
+    }): Promise<unknown>;
+    listSuppliers(params?: {
+        from?: string;
+        count?: string;
+    }): Promise<unknown>;
+    listSupplierInvoices(params?: {
+        from?: string;
+        count?: string;
+        invoiceDateFrom?: string;
+    }): Promise<unknown>;
+    listLedgerEntries(params?: {
+        dateFrom?: string;
+        dateTo?: string;
+        from?: string;
+        count?: string;
+    }): Promise<unknown>;
+    createVoucher(v: {
+        date: string;
+        description?: string;
+        postings: Array<{
+            account: {
+                id: number;
+            };
+            amount: number;
+            description?: string;
+        }>;
+    }): Promise<unknown>;
+    listAccounts(params?: {
+        from?: string;
+        count?: string;
+    }): Promise<unknown>;
+    listProjects(params?: {
+        from?: string;
+        count?: string;
+    }): Promise<unknown>;
+    listEmployees(params?: {
+        from?: string;
+        count?: string;
+    }): Promise<unknown>;
+    getCompany(): Promise<unknown>;
+    listProducts(params?: {
+        from?: string;
+        count?: string;
+    }): Promise<unknown>;
+}

package/dist/tripletex-client.js

@@ -0,0 +1,43 @@
+/**
+ * Tripletex REST API client (Norwegian ERP/accounting).
+ * API docs: https://tripletex.no/v2-docs
+ * Auth: Basic auth with sessionToken (0:sessionToken)
+ */
+const BASE_URL = "https://tripletex.no/v2";
+export class TripletexClient {
+    sessionToken;
+    constructor(sessionToken) {
+        this.sessionToken = sessionToken;
+    }
+    async request(method, path, body, params) {
+        const url = new URL(`${BASE_URL}${path}`);
+        if (params)
+            for (const [k, v] of Object.entries(params)) {
+                if (v)
+                    url.searchParams.set(k, v);
+            }
+        const res = await fetch(url.toString(), {
+            method, headers: { Authorization: `Basic ${Buffer.from(`0:${this.sessionToken}`).toString("base64")}`, "Content-Type": "application/json", Accept: "application/json" },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok)
+            throw new Error(`Tripletex API error ${res.status}: ${await res.text()}`);
+        return res.json();
+    }
+    async listInvoices(params) { return this.request("GET", "/invoice", undefined, params); }
+    async getInvoice(id) { return this.request("GET", `/invoice/${id}`); }
+    async createInvoice(invoice) { return this.request("POST", "/invoice", invoice); }
+    async sendInvoice(id, sendType = "EMAIL") { return this.request("PUT", `/invoice/${id}/:send`, { sendType }); }
+    async listCustomers(params) { return this.request("GET", "/customer", undefined, params); }
+    async getCustomer(id) { return this.request("GET", `/customer/${id}`); }
+    async createCustomer(c) { return this.request("POST", "/customer", c); }
+    async listSuppliers(params) { return this.request("GET", "/supplier", undefined, params); }
+    async listSupplierInvoices(params) { return this.request("GET", "/supplierInvoice", undefined, params); }
+    async listLedgerEntries(params) { return this.request("GET", "/ledger/posting", undefined, params); }
+    async createVoucher(v) { return this.request("POST", "/ledger/voucher", v); }
+    async listAccounts(params) { return this.request("GET", "/ledger/account", undefined, params); }
+    async listProjects(params) { return this.request("GET", "/project", undefined, params); }
+    async listEmployees(params) { return this.request("GET", "/employee", undefined, params); }
+    async getCompany() { return this.request("GET", "/company"); }
+    async listProducts(params) { return this.request("GET", "/product", undefined, params); }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "tripletex-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Tripletex — Norwegian ERP and accounting platform. Manage invoices, customers, employees, projects, and more via AI agents.",
+  "main": "dist/index.js",
+  "bin": {
+    "tripletex-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "tripletex",
+    "accounting",
+    "erp",
+    "norway",
+    "norwegian",
+    "regnskap",
+    "model-context-protocol"
+  ],
+  "author": "Viggo Johansson",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { TripletexClient } from "./tripletex-client.js";
+
+const server = new McpServer({ name: "tripletex-mcp-server", version: "1.0.0" });
+function getClient(): TripletexClient {
+  const token = process.env.TRIPLETEX_SESSION_TOKEN;
+  if (!token) throw new Error("TRIPLETEX_SESSION_TOKEN is required. Create one at tripletex.no → Company settings → API access.");
+  return new TripletexClient(token);
+}
+function json(data: unknown) { return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] }; }
+
+server.tool("list_invoices", "List invoices.", { invoiceDateFrom: z.string().optional(), invoiceDateTo: z.string().optional(), count: z.string().optional() }, async (p) => json(await getClient().listInvoices(p)));
+server.tool("get_invoice", "Get invoice details.", { id: z.string() }, async ({ id }) => json(await getClient().getInvoice(id)));
+server.tool("send_invoice", "Send invoice via email.", { id: z.string(), sendType: z.string().optional().describe("EMAIL or EHF") }, async ({ id, sendType }) => json(await getClient().sendInvoice(id, sendType)));
+server.tool("list_customers", "Search customers.", { name: z.string().optional(), count: z.string().optional() }, async (p) => json(await getClient().listCustomers(p)));
+server.tool("get_customer", "Get customer details.", { id: z.string() }, async ({ id }) => json(await getClient().getCustomer(id)));
+server.tool("create_customer", "Create a customer.", {
+  name: z.string(), email: z.string().optional(), organizationNumber: z.string().optional(), phone: z.string().optional(),
+  address: z.string().optional(), postalCode: z.string().optional(), city: z.string().optional(),
+}, async ({ name, email, organizationNumber, phone, address, postalCode, city }) => json(await getClient().createCustomer({ name, email, organizationNumber, phoneNumber: phone, postalAddress: address ? { addressLine1: address, postalCode, city } : undefined })));
+server.tool("list_suppliers", "List suppliers.", { count: z.string().optional() }, async (p) => json(await getClient().listSuppliers(p)));
+server.tool("list_supplier_invoices", "List supplier invoices.", { invoiceDateFrom: z.string().optional(), count: z.string().optional() }, async (p) => json(await getClient().listSupplierInvoices(p)));
+server.tool("list_ledger_entries", "List ledger postings.", { dateFrom: z.string().optional(), dateTo: z.string().optional(), count: z.string().optional() }, async (p) => json(await getClient().listLedgerEntries(p)));
+server.tool("create_voucher", "Create a journal voucher.", {
+  date: z.string(), description: z.string().optional(),
+  postings: z.array(z.object({ accountId: z.number(), amount: z.number(), description: z.string().optional() })),
+}, async ({ date, description, postings }) => json(await getClient().createVoucher({ date, description, postings: postings.map(p => ({ account: { id: p.accountId }, amount: p.amount, description: p.description })) })));
+server.tool("list_accounts", "Get chart of accounts.", { count: z.string().optional() }, async (p) => json(await getClient().listAccounts(p)));
+server.tool("list_projects", "List projects.", { count: z.string().optional() }, async (p) => json(await getClient().listProjects(p)));
+server.tool("list_employees", "List employees.", { count: z.string().optional() }, async (p) => json(await getClient().listEmployees(p)));
+server.tool("list_products", "List products.", { count: z.string().optional() }, async (p) => json(await getClient().listProducts(p)));
+server.tool("get_company_info", "Get company info.", {}, async () => json(await getClient().getCompany()));
+
+async function main() { await server.connect(new StdioServerTransport()); }
+main().catch((e) => { console.error("Server error:", e); process.exit(1); });

package/src/tripletex-client.ts

@@ -0,0 +1,42 @@
+/**
+ * Tripletex REST API client (Norwegian ERP/accounting).
+ * API docs: https://tripletex.no/v2-docs
+ * Auth: Basic auth with sessionToken (0:sessionToken)
+ */
+const BASE_URL = "https://tripletex.no/v2";
+
+export class TripletexClient {
+  constructor(private sessionToken: string) {}
+
+  private async request<T>(method: string, path: string, body?: unknown, params?: Record<string, string>): Promise<T> {
+    const url = new URL(`${BASE_URL}${path}`);
+    if (params) for (const [k, v] of Object.entries(params)) { if (v) url.searchParams.set(k, v); }
+    const res = await fetch(url.toString(), {
+      method, headers: { Authorization: `Basic ${Buffer.from(`0:${this.sessionToken}`).toString("base64")}`, "Content-Type": "application/json", Accept: "application/json" },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) throw new Error(`Tripletex API error ${res.status}: ${await res.text()}`);
+    return res.json() as Promise<T>;
+  }
+
+  async listInvoices(params?: { invoiceDateFrom?: string; invoiceDateTo?: string; from?: string; count?: string }) { return this.request<unknown>("GET", "/invoice", undefined, params); }
+  async getInvoice(id: string) { return this.request<unknown>("GET", `/invoice/${id}`); }
+  async createInvoice(invoice: { invoiceDate: string; invoiceDueDate: string; orders: Array<{ id: number }> }) { return this.request<unknown>("POST", "/invoice", invoice); }
+  async sendInvoice(id: string, sendType: string = "EMAIL") { return this.request<unknown>("PUT", `/invoice/${id}/:send`, { sendType }); }
+
+  async listCustomers(params?: { name?: string; from?: string; count?: string }) { return this.request<unknown>("GET", "/customer", undefined, params); }
+  async getCustomer(id: string) { return this.request<unknown>("GET", `/customer/${id}`); }
+  async createCustomer(c: { name: string; email?: string; organizationNumber?: string; phoneNumber?: string; postalAddress?: { addressLine1?: string; postalCode?: string; city?: string; country?: { id?: number } } }) { return this.request<unknown>("POST", "/customer", c); }
+
+  async listSuppliers(params?: { from?: string; count?: string }) { return this.request<unknown>("GET", "/supplier", undefined, params); }
+  async listSupplierInvoices(params?: { from?: string; count?: string; invoiceDateFrom?: string }) { return this.request<unknown>("GET", "/supplierInvoice", undefined, params); }
+
+  async listLedgerEntries(params?: { dateFrom?: string; dateTo?: string; from?: string; count?: string }) { return this.request<unknown>("GET", "/ledger/posting", undefined, params); }
+  async createVoucher(v: { date: string; description?: string; postings: Array<{ account: { id: number }; amount: number; description?: string }> }) { return this.request<unknown>("POST", "/ledger/voucher", v); }
+  async listAccounts(params?: { from?: string; count?: string }) { return this.request<unknown>("GET", "/ledger/account", undefined, params); }
+
+  async listProjects(params?: { from?: string; count?: string }) { return this.request<unknown>("GET", "/project", undefined, params); }
+  async listEmployees(params?: { from?: string; count?: string }) { return this.request<unknown>("GET", "/employee", undefined, params); }
+  async getCompany() { return this.request<unknown>("GET", "/company"); }
+  async listProducts(params?: { from?: string; count?: string }) { return this.request<unknown>("GET", "/product", undefined, params); }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"]
+}