visma-eaccounting-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# Visma eAccounting MCP Server
+
+Connect AI agents to **Visma eAccounting** — used by businesses across Norway, Finland, Netherlands, and UK.
+
+Manage invoices, customers, suppliers, accounting entries, orders, and more through the Model Context Protocol.
+
+## Tools (20)
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Invoices** | `list_invoices`, `get_invoice`, `create_invoice`, `send_invoice`, `list_invoice_payments` | Create, send, and track invoices |
+| **Customers** | `list_customers`, `get_customer`, `create_customer` | Manage your customer database |
+| **Suppliers** | `list_supplier_invoices`, `get_supplier`, `create_supplier_invoice` | Track bills and expenses |
+| **Accounting** | `list_vouchers`, `create_voucher`, `list_accounts`, `list_fiscal_years` | Journal entries and chart of accounts |
+| **Reports** | `get_company_info`, `list_projects`, `list_cost_centers` | Company info and cost tracking |
+| **Orders** | `list_orders`, `create_quote` | Sales orders and quotes |
+
+## Quick Start
+
+### 1. Get a Visma Access Token
+
+Register as a partner at [developer.visma.com](https://developer.visma.com/api/eaccounting) and create an application to get your OAuth2 credentials.
+
+### 2. Configure in Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "visma": {
+      "command": "npx",
+      "args": ["-y", "visma-eaccounting-mcp-server"],
+      "env": {
+        "VISMA_ACCESS_TOKEN": "your-access-token-here"
+      }
+    }
+  }
+}
+```
+
+### 3. Start Using
+
+Ask Claude things like:
+- "List all unpaid invoices"
+- "Create an invoice for customer X with 5 hours consulting at 150 EUR/hr"
+- "What supplier invoices are due this week?"
+- "Show me the chart of accounts"
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `VISMA_ACCESS_TOKEN` | Yes | OAuth2 access token from Visma |
+
+## API Reference
+
+This server wraps the [Visma eAccounting API v2](https://developer.visma.com/api/eaccounting). Rate limit: 600 requests per minute.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Visma eAccounting MCP Server
+ *
+ * Connects AI agents to Visma eAccounting — used across Norway, Finland,
+ * Netherlands, and UK. Manage invoices, customers, suppliers, and more.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+/**
+ * Visma eAccounting MCP Server
+ *
+ * Connects AI agents to Visma eAccounting — used across Norway, Finland,
+ * Netherlands, and UK. Manage invoices, customers, suppliers, and more.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { VismaClient } from "./visma-client.js";
+const server = new McpServer({
+    name: "visma-eaccounting-mcp-server",
+    version: "1.0.0",
+});
+function getClient() {
+    const token = process.env.VISMA_ACCESS_TOKEN;
+    if (!token) {
+        throw new Error("VISMA_ACCESS_TOKEN environment variable is required. " +
+            "Register as a partner at https://developer.visma.com to get credentials.");
+    }
+    return new VismaClient({ accessToken: token });
+}
+function jsonResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+// ── INVOICES (5 tools) ────────────────────────────────────────
+server.tool("list_invoices", "List and filter customer invoices. Uses OData $filter syntax.", {
+    filter: z.string().optional().describe("OData filter (e.g. \"IsPaid eq false\")"),
+    top: z.string().optional().describe("Number of results to return"),
+    skip: z.string().optional().describe("Number of results to skip (pagination)"),
+}, async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listCustomerInvoices({
+        $filter: filter,
+        $top: top,
+        $skip: skip,
+    });
+    return jsonResponse(result);
+});
+server.tool("get_invoice", "Get full details of a specific customer invoice.", {
+    id: z.string().describe("Invoice ID (GUID)"),
+}, async ({ id }) => {
+    const client = getClient();
+    const result = await client.getCustomerInvoice(id);
+    return jsonResponse(result);
+});
+server.tool("create_invoice", "Create a new customer invoice with line items.", {
+    customerId: z.string().describe("Customer ID (GUID)"),
+    rows: z.array(z.object({
+        text: z.string().describe("Line item description"),
+        quantity: z.number().describe("Quantity"),
+        unitPrice: z.number().describe("Unit price"),
+        articleId: z.string().optional().describe("Article/product ID"),
+        accountNumber: z.number().optional().describe("Account number"),
+    })).describe("Invoice line items"),
+    dueDate: z.string().optional().describe("Due date (YYYY-MM-DD)"),
+    invoiceDate: z.string().optional().describe("Invoice date (YYYY-MM-DD)"),
+    currencyCode: z.string().optional().describe("Currency (e.g. NOK, EUR, SEK)"),
+    ourReference: z.string().optional().describe("Your reference"),
+    yourReference: z.string().optional().describe("Customer's reference"),
+}, async ({ customerId, rows, dueDate, invoiceDate, currencyCode, ourReference, yourReference }) => {
+    const client = getClient();
+    const result = await client.createCustomerInvoice({
+        CustomerId: customerId,
+        Rows: rows.map((r) => ({
+            Text: r.text,
+            Quantity: r.quantity,
+            UnitPrice: r.unitPrice,
+            ArticleId: r.articleId,
+            AccountNumber: r.accountNumber,
+        })),
+        DueDate: dueDate,
+        InvoiceDate: invoiceDate,
+        CurrencyCode: currencyCode,
+        OurReference: ourReference,
+        YourReference: yourReference,
+    });
+    return jsonResponse(result);
+});
+server.tool("send_invoice", "Send a customer invoice via email.", {
+    id: z.string().describe("Invoice ID (GUID) to send"),
+}, async ({ id }) => {
+    const client = getClient();
+    const result = await client.sendCustomerInvoice(id);
+    return jsonResponse(result);
+});
+server.tool("list_invoice_payments", "List customer invoice payments.", {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+}, async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listCustomerInvoicePayments({
+        $filter: filter,
+        $top: top,
+        $skip: skip,
+    });
+    return jsonResponse(result);
+});
+// ── CUSTOMERS (3 tools) ───────────────────────────────────────
+server.tool("list_customers", "Search and filter customers.", {
+    filter: z.string().optional().describe("OData filter (e.g. \"contains(Name,'Acme')\")"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+}, async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listCustomers({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+});
+server.tool("get_customer", "Get full details of a specific customer.", {
+    id: z.string().describe("Customer ID (GUID)"),
+}, async ({ id }) => {
+    const client = getClient();
+    const result = await client.getCustomer(id);
+    return jsonResponse(result);
+});
+server.tool("create_customer", "Add a new customer.", {
+    name: z.string().describe("Customer/company name"),
+    email: z.string().optional().describe("Email address"),
+    corporateIdentityNumber: z.string().optional().describe("Organisation number"),
+    phone: z.string().optional().describe("Phone number"),
+    address: z.string().optional().describe("Street address"),
+    zipCode: z.string().optional().describe("Postal code"),
+    city: z.string().optional().describe("City"),
+    countryCode: z.string().optional().describe("Country code (e.g. NO, FI, SE)"),
+    currencyCode: z.string().optional().describe("Default currency (e.g. NOK, EUR)"),
+}, async ({ name, email, corporateIdentityNumber, phone, address, zipCode, city, countryCode, currencyCode }) => {
+    const client = getClient();
+    const result = await client.createCustomer({
+        Name: name,
+        EmailAddress: email,
+        CorporateIdentityNumber: corporateIdentityNumber,
+        Telephone: phone,
+        Address1: address,
+        ZipCode: zipCode,
+        City: city,
+        CountryCode: countryCode,
+        CurrencyCode: currencyCode,
+    });
+    return jsonResponse(result);
+});
+// ── SUPPLIERS & EXPENSES (3 tools) ────────────────────────────
+server.tool("list_supplier_invoices", "List incoming supplier invoices (bills/expenses).", {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+}, async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listSupplierInvoices({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+});
+server.tool("get_supplier", "Get details of a specific supplier/vendor.", {
+    id: z.string().describe("Supplier ID (GUID)"),
+}, async ({ id }) => {
+    const client = getClient();
+    const result = await client.getSupplier(id);
+    return jsonResponse(result);
+});
+server.tool("create_supplier_invoice", "Record a new supplier invoice (expense/bill).", {
+    supplierId: z.string().describe("Supplier ID (GUID)"),
+    rows: z.array(z.object({
+        accountNumber: z.number().describe("Account number"),
+        debitAmount: z.number().optional().describe("Debit amount"),
+        creditAmount: z.number().optional().describe("Credit amount"),
+    })).describe("Invoice accounting rows (must balance)"),
+    invoiceDate: z.string().optional().describe("Invoice date (YYYY-MM-DD)"),
+    dueDate: z.string().optional().describe("Due date (YYYY-MM-DD)"),
+    totalAmount: z.number().optional().describe("Total amount"),
+}, async ({ supplierId, rows, invoiceDate, dueDate, totalAmount }) => {
+    const client = getClient();
+    const result = await client.createSupplierInvoice({
+        SupplierId: supplierId,
+        Rows: rows.map((r) => ({
+            AccountNumber: r.accountNumber,
+            DebitAmount: r.debitAmount,
+            CreditAmount: r.creditAmount,
+        })),
+        InvoiceDate: invoiceDate,
+        DueDate: dueDate,
+        TotalAmount: totalAmount,
+    });
+    return jsonResponse(result);
+});
+// ── ACCOUNTING (4 tools) ──────────────────────────────────────
+server.tool("list_vouchers", "List journal entries/vouchers.", {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+}, async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listVouchers({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+});
+server.tool("create_voucher", "Create a manual journal entry. Rows must balance (total debit = total credit).", {
+    description: z.string().describe("Voucher description"),
+    voucherDate: z.string().describe("Date (YYYY-MM-DD)"),
+    rows: z.array(z.object({
+        accountNumber: z.number().describe("Account number"),
+        debitAmount: z.number().optional().describe("Debit amount"),
+        creditAmount: z.number().optional().describe("Credit amount"),
+        description: z.string().optional().describe("Row description"),
+    })).describe("Voucher rows (must balance)"),
+}, async ({ description, voucherDate, rows }) => {
+    const client = getClient();
+    const result = await client.createVoucher({
+        Description: description,
+        VoucherDate: voucherDate,
+        Rows: rows.map((r) => ({
+            AccountNumber: r.accountNumber,
+            DebitAmount: r.debitAmount,
+            CreditAmount: r.creditAmount,
+            Description: r.description,
+        })),
+    });
+    return jsonResponse(result);
+});
+server.tool("list_accounts", "Get the chart of accounts.", {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+}, async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listAccounts({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+});
+server.tool("list_fiscal_years", "Get information about fiscal/accounting years.", {}, async () => {
+    const client = getClient();
+    const result = await client.listFiscalYears();
+    return jsonResponse(result);
+});
+// ── REPORTS & ANALYTICS (3 tools) ─────────────────────────────
+server.tool("get_company_info", "Get company information and settings.", {}, async () => {
+    const client = getClient();
+    const result = await client.getCompanyInfo();
+    return jsonResponse(result);
+});
+server.tool("list_projects", "List all projects.", {
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+}, async ({ top, skip }) => {
+    const client = getClient();
+    const result = await client.listProjects({ $top: top, $skip: skip });
+    return jsonResponse(result);
+});
+server.tool("list_cost_centers", "List cost centers for expense allocation.", {
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+}, async ({ top, skip }) => {
+    const client = getClient();
+    const result = await client.listCostCenters({ $top: top, $skip: skip });
+    return jsonResponse(result);
+});
+// ── ORDERS & QUOTES (2 tools) ─────────────────────────────────
+server.tool("list_orders", "List and filter sales orders.", {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+}, async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listOrders({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+});
+server.tool("create_quote", "Create a quote/offer for a customer.", {
+    customerId: z.string().describe("Customer ID (GUID)"),
+    rows: z.array(z.object({
+        text: z.string().describe("Line item description"),
+        quantity: z.number().describe("Quantity"),
+        unitPrice: z.number().describe("Unit price"),
+        articleId: z.string().optional().describe("Article ID"),
+    })).describe("Quote line items"),
+    quoteDate: z.string().optional().describe("Quote date (YYYY-MM-DD)"),
+    expirationDate: z.string().optional().describe("Expiry date (YYYY-MM-DD)"),
+    ourReference: z.string().optional().describe("Your reference"),
+    yourReference: z.string().optional().describe("Customer's reference"),
+}, async ({ customerId, rows, quoteDate, expirationDate, ourReference, yourReference }) => {
+    const client = getClient();
+    const result = await client.createQuote({
+        CustomerId: customerId,
+        Rows: rows.map((r) => ({
+            Text: r.text,
+            Quantity: r.quantity,
+            UnitPrice: r.unitPrice,
+            ArticleId: r.articleId,
+        })),
+        QuoteDate: quoteDate,
+        ExpirationDate: expirationDate,
+        OurReference: ourReference,
+        YourReference: yourReference,
+    });
+    return jsonResponse(result);
+});
+// ── Start server ──────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/dist/visma-client.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Visma eAccounting REST API client.
+ * API docs: https://eaccountingapi.vismaonline.com/swagger/ui/index
+ * Production: https://eaccountingapi.vismaonline.com/v2
+ */
+interface VismaConfig {
+    accessToken: string;
+}
+export declare class VismaClient {
+    private accessToken;
+    constructor(config: VismaConfig);
+    private request;
+    listCustomerInvoices(params?: {
+        $filter?: string;
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    getCustomerInvoice(id: string): Promise<unknown>;
+    createCustomerInvoice(invoice: {
+        CustomerId: string;
+        Rows: Array<{
+            ArticleId?: string;
+            Text?: string;
+            Quantity?: number;
+            UnitPrice?: number;
+            AccountNumber?: number;
+        }>;
+        DueDate?: string;
+        InvoiceDate?: string;
+        CurrencyCode?: string;
+        YourReference?: string;
+        OurReference?: string;
+    }): Promise<unknown>;
+    sendCustomerInvoice(id: string): Promise<unknown>;
+    listCustomerInvoicePayments(params?: {
+        $filter?: string;
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    listCustomers(params?: {
+        $filter?: string;
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    getCustomer(id: string): Promise<unknown>;
+    createCustomer(customer: {
+        Name: string;
+        EmailAddress?: string;
+        CorporateIdentityNumber?: string;
+        Telephone?: string;
+        Address1?: string;
+        ZipCode?: string;
+        City?: string;
+        CountryCode?: string;
+        CurrencyCode?: string;
+    }): Promise<unknown>;
+    listSupplierInvoices(params?: {
+        $filter?: string;
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    getSupplier(id: string): Promise<unknown>;
+    createSupplierInvoice(invoice: {
+        SupplierId: string;
+        InvoiceDate?: string;
+        DueDate?: string;
+        TotalAmount?: number;
+        Rows: Array<{
+            AccountNumber: number;
+            DebitAmount?: number;
+            CreditAmount?: number;
+        }>;
+    }): Promise<unknown>;
+    listVouchers(params?: {
+        $filter?: string;
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    createVoucher(voucher: {
+        Description: string;
+        VoucherDate: string;
+        VoucherSeriesId?: string;
+        Rows: Array<{
+            AccountNumber: number;
+            DebitAmount?: number;
+            CreditAmount?: number;
+            Description?: string;
+        }>;
+    }): Promise<unknown>;
+    listAccounts(params?: {
+        $filter?: string;
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    listFiscalYears(): Promise<unknown>;
+    getCompanyInfo(): Promise<unknown>;
+    listProjects(params?: {
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    listCostCenters(params?: {
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    listOrders(params?: {
+        $filter?: string;
+        $top?: string;
+        $skip?: string;
+    }): Promise<unknown>;
+    createQuote(quote: {
+        CustomerId: string;
+        Rows: Array<{
+            ArticleId?: string;
+            Text?: string;
+            Quantity?: number;
+            UnitPrice?: number;
+        }>;
+        QuoteDate?: string;
+        ExpirationDate?: string;
+        YourReference?: string;
+        OurReference?: string;
+    }): Promise<unknown>;
+}
+export {};

package/dist/visma-client.js

@@ -0,0 +1,104 @@
+/**
+ * Visma eAccounting REST API client.
+ * API docs: https://eaccountingapi.vismaonline.com/swagger/ui/index
+ * Production: https://eaccountingapi.vismaonline.com/v2
+ */
+const BASE_URL = "https://eaccountingapi.vismaonline.com/v2";
+export class VismaClient {
+    accessToken;
+    constructor(config) {
+        this.accessToken = config.accessToken;
+    }
+    async request(method, path, body, params) {
+        const url = new URL(`${BASE_URL}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.accessToken}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Visma API error ${response.status}: ${errorText}`);
+        }
+        return response.json();
+    }
+    // ── Invoices ──────────────────────────────────────────────
+    async listCustomerInvoices(params) {
+        return this.request("GET", "/customerinvoices", undefined, params);
+    }
+    async getCustomerInvoice(id) {
+        return this.request("GET", `/customerinvoices/${id}`);
+    }
+    async createCustomerInvoice(invoice) {
+        return this.request("POST", "/customerinvoices", invoice);
+    }
+    async sendCustomerInvoice(id) {
+        return this.request("POST", `/customerinvoices/${id}/send`, { SendType: 1 } // 1 = Email
+        );
+    }
+    async listCustomerInvoicePayments(params) {
+        return this.request("GET", "/customerinvoicepayments", undefined, params);
+    }
+    // ── Customers ─────────────────────────────────────────────
+    async listCustomers(params) {
+        return this.request("GET", "/customers", undefined, params);
+    }
+    async getCustomer(id) {
+        return this.request("GET", `/customers/${id}`);
+    }
+    async createCustomer(customer) {
+        return this.request("POST", "/customers", customer);
+    }
+    // ── Suppliers & Expenses ──────────────────────────────────
+    async listSupplierInvoices(params) {
+        return this.request("GET", "/supplierinvoices", undefined, params);
+    }
+    async getSupplier(id) {
+        return this.request("GET", `/suppliers/${id}`);
+    }
+    async createSupplierInvoice(invoice) {
+        return this.request("POST", "/supplierinvoices", invoice);
+    }
+    // ── Accounting ────────────────────────────────────────────
+    async listVouchers(params) {
+        return this.request("GET", "/vouchers", undefined, params);
+    }
+    async createVoucher(voucher) {
+        return this.request("POST", "/vouchers", voucher);
+    }
+    async listAccounts(params) {
+        return this.request("GET", "/accounts", undefined, params);
+    }
+    async listFiscalYears() {
+        return this.request("GET", "/fiscalyears");
+    }
+    // ── Reports & Analytics ───────────────────────────────────
+    async getCompanyInfo() {
+        return this.request("GET", "/companysettings");
+    }
+    async listProjects(params) {
+        return this.request("GET", "/projects", undefined, params);
+    }
+    async listCostCenters(params) {
+        return this.request("GET", "/costcenters", undefined, params);
+    }
+    // ── Orders & Quotes ───────────────────────────────────────
+    async listOrders(params) {
+        return this.request("GET", "/orders", undefined, params);
+    }
+    async createQuote(quote) {
+        return this.request("POST", "/quotes", quote);
+    }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "visma-eaccounting-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Visma eAccounting — manage invoices, customers, suppliers, and accounting via AI agents. Covers Norway, Finland, Netherlands, UK.",
+  "main": "dist/index.js",
+  "bin": {
+    "visma-eaccounting-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "visma",
+    "eaccounting",
+    "accounting",
+    "nordic",
+    "invoices",
+    "bookkeeping",
+    "ai",
+    "model-context-protocol",
+    "norway",
+    "finland"
+  ],
+  "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,439 @@
+#!/usr/bin/env node
+
+/**
+ * Visma eAccounting MCP Server
+ *
+ * Connects AI agents to Visma eAccounting — used across Norway, Finland,
+ * Netherlands, and UK. Manage invoices, customers, suppliers, and more.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { VismaClient } from "./visma-client.js";
+
+const server = new McpServer({
+  name: "visma-eaccounting-mcp-server",
+  version: "1.0.0",
+});
+
+function getClient(): VismaClient {
+  const token = process.env.VISMA_ACCESS_TOKEN;
+  if (!token) {
+    throw new Error(
+      "VISMA_ACCESS_TOKEN environment variable is required. " +
+        "Register as a partner at https://developer.visma.com to get credentials."
+    );
+  }
+  return new VismaClient({ accessToken: token });
+}
+
+function jsonResponse(data: unknown) {
+  return {
+    content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }],
+  };
+}
+
+// ── INVOICES (5 tools) ────────────────────────────────────────
+
+server.tool(
+  "list_invoices",
+  "List and filter customer invoices. Uses OData $filter syntax.",
+  {
+    filter: z.string().optional().describe("OData filter (e.g. \"IsPaid eq false\")"),
+    top: z.string().optional().describe("Number of results to return"),
+    skip: z.string().optional().describe("Number of results to skip (pagination)"),
+  },
+  async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listCustomerInvoices({
+      $filter: filter,
+      $top: top,
+      $skip: skip,
+    });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "get_invoice",
+  "Get full details of a specific customer invoice.",
+  {
+    id: z.string().describe("Invoice ID (GUID)"),
+  },
+  async ({ id }) => {
+    const client = getClient();
+    const result = await client.getCustomerInvoice(id);
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_invoice",
+  "Create a new customer invoice with line items.",
+  {
+    customerId: z.string().describe("Customer ID (GUID)"),
+    rows: z.array(z.object({
+      text: z.string().describe("Line item description"),
+      quantity: z.number().describe("Quantity"),
+      unitPrice: z.number().describe("Unit price"),
+      articleId: z.string().optional().describe("Article/product ID"),
+      accountNumber: z.number().optional().describe("Account number"),
+    })).describe("Invoice line items"),
+    dueDate: z.string().optional().describe("Due date (YYYY-MM-DD)"),
+    invoiceDate: z.string().optional().describe("Invoice date (YYYY-MM-DD)"),
+    currencyCode: z.string().optional().describe("Currency (e.g. NOK, EUR, SEK)"),
+    ourReference: z.string().optional().describe("Your reference"),
+    yourReference: z.string().optional().describe("Customer's reference"),
+  },
+  async ({ customerId, rows, dueDate, invoiceDate, currencyCode, ourReference, yourReference }) => {
+    const client = getClient();
+    const result = await client.createCustomerInvoice({
+      CustomerId: customerId,
+      Rows: rows.map((r) => ({
+        Text: r.text,
+        Quantity: r.quantity,
+        UnitPrice: r.unitPrice,
+        ArticleId: r.articleId,
+        AccountNumber: r.accountNumber,
+      })),
+      DueDate: dueDate,
+      InvoiceDate: invoiceDate,
+      CurrencyCode: currencyCode,
+      OurReference: ourReference,
+      YourReference: yourReference,
+    });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "send_invoice",
+  "Send a customer invoice via email.",
+  {
+    id: z.string().describe("Invoice ID (GUID) to send"),
+  },
+  async ({ id }) => {
+    const client = getClient();
+    const result = await client.sendCustomerInvoice(id);
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_invoice_payments",
+  "List customer invoice payments.",
+  {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+  },
+  async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listCustomerInvoicePayments({
+      $filter: filter,
+      $top: top,
+      $skip: skip,
+    });
+    return jsonResponse(result);
+  }
+);
+
+// ── CUSTOMERS (3 tools) ───────────────────────────────────────
+
+server.tool(
+  "list_customers",
+  "Search and filter customers.",
+  {
+    filter: z.string().optional().describe("OData filter (e.g. \"contains(Name,'Acme')\")"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+  },
+  async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listCustomers({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "get_customer",
+  "Get full details of a specific customer.",
+  {
+    id: z.string().describe("Customer ID (GUID)"),
+  },
+  async ({ id }) => {
+    const client = getClient();
+    const result = await client.getCustomer(id);
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_customer",
+  "Add a new customer.",
+  {
+    name: z.string().describe("Customer/company name"),
+    email: z.string().optional().describe("Email address"),
+    corporateIdentityNumber: z.string().optional().describe("Organisation number"),
+    phone: z.string().optional().describe("Phone number"),
+    address: z.string().optional().describe("Street address"),
+    zipCode: z.string().optional().describe("Postal code"),
+    city: z.string().optional().describe("City"),
+    countryCode: z.string().optional().describe("Country code (e.g. NO, FI, SE)"),
+    currencyCode: z.string().optional().describe("Default currency (e.g. NOK, EUR)"),
+  },
+  async ({ name, email, corporateIdentityNumber, phone, address, zipCode, city, countryCode, currencyCode }) => {
+    const client = getClient();
+    const result = await client.createCustomer({
+      Name: name,
+      EmailAddress: email,
+      CorporateIdentityNumber: corporateIdentityNumber,
+      Telephone: phone,
+      Address1: address,
+      ZipCode: zipCode,
+      City: city,
+      CountryCode: countryCode,
+      CurrencyCode: currencyCode,
+    });
+    return jsonResponse(result);
+  }
+);
+
+// ── SUPPLIERS & EXPENSES (3 tools) ────────────────────────────
+
+server.tool(
+  "list_supplier_invoices",
+  "List incoming supplier invoices (bills/expenses).",
+  {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+  },
+  async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listSupplierInvoices({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "get_supplier",
+  "Get details of a specific supplier/vendor.",
+  {
+    id: z.string().describe("Supplier ID (GUID)"),
+  },
+  async ({ id }) => {
+    const client = getClient();
+    const result = await client.getSupplier(id);
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_supplier_invoice",
+  "Record a new supplier invoice (expense/bill).",
+  {
+    supplierId: z.string().describe("Supplier ID (GUID)"),
+    rows: z.array(z.object({
+      accountNumber: z.number().describe("Account number"),
+      debitAmount: z.number().optional().describe("Debit amount"),
+      creditAmount: z.number().optional().describe("Credit amount"),
+    })).describe("Invoice accounting rows (must balance)"),
+    invoiceDate: z.string().optional().describe("Invoice date (YYYY-MM-DD)"),
+    dueDate: z.string().optional().describe("Due date (YYYY-MM-DD)"),
+    totalAmount: z.number().optional().describe("Total amount"),
+  },
+  async ({ supplierId, rows, invoiceDate, dueDate, totalAmount }) => {
+    const client = getClient();
+    const result = await client.createSupplierInvoice({
+      SupplierId: supplierId,
+      Rows: rows.map((r) => ({
+        AccountNumber: r.accountNumber,
+        DebitAmount: r.debitAmount,
+        CreditAmount: r.creditAmount,
+      })),
+      InvoiceDate: invoiceDate,
+      DueDate: dueDate,
+      TotalAmount: totalAmount,
+    });
+    return jsonResponse(result);
+  }
+);
+
+// ── ACCOUNTING (4 tools) ──────────────────────────────────────
+
+server.tool(
+  "list_vouchers",
+  "List journal entries/vouchers.",
+  {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+  },
+  async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listVouchers({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_voucher",
+  "Create a manual journal entry. Rows must balance (total debit = total credit).",
+  {
+    description: z.string().describe("Voucher description"),
+    voucherDate: z.string().describe("Date (YYYY-MM-DD)"),
+    rows: z.array(z.object({
+      accountNumber: z.number().describe("Account number"),
+      debitAmount: z.number().optional().describe("Debit amount"),
+      creditAmount: z.number().optional().describe("Credit amount"),
+      description: z.string().optional().describe("Row description"),
+    })).describe("Voucher rows (must balance)"),
+  },
+  async ({ description, voucherDate, rows }) => {
+    const client = getClient();
+    const result = await client.createVoucher({
+      Description: description,
+      VoucherDate: voucherDate,
+      Rows: rows.map((r) => ({
+        AccountNumber: r.accountNumber,
+        DebitAmount: r.debitAmount,
+        CreditAmount: r.creditAmount,
+        Description: r.description,
+      })),
+    });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_accounts",
+  "Get the chart of accounts.",
+  {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+  },
+  async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listAccounts({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_fiscal_years",
+  "Get information about fiscal/accounting years.",
+  {},
+  async () => {
+    const client = getClient();
+    const result = await client.listFiscalYears();
+    return jsonResponse(result);
+  }
+);
+
+// ── REPORTS & ANALYTICS (3 tools) ─────────────────────────────
+
+server.tool(
+  "get_company_info",
+  "Get company information and settings.",
+  {},
+  async () => {
+    const client = getClient();
+    const result = await client.getCompanyInfo();
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_projects",
+  "List all projects.",
+  {
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+  },
+  async ({ top, skip }) => {
+    const client = getClient();
+    const result = await client.listProjects({ $top: top, $skip: skip });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "list_cost_centers",
+  "List cost centers for expense allocation.",
+  {
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+  },
+  async ({ top, skip }) => {
+    const client = getClient();
+    const result = await client.listCostCenters({ $top: top, $skip: skip });
+    return jsonResponse(result);
+  }
+);
+
+// ── ORDERS & QUOTES (2 tools) ─────────────────────────────────
+
+server.tool(
+  "list_orders",
+  "List and filter sales orders.",
+  {
+    filter: z.string().optional().describe("OData filter"),
+    top: z.string().optional().describe("Number of results"),
+    skip: z.string().optional().describe("Skip for pagination"),
+  },
+  async ({ filter, top, skip }) => {
+    const client = getClient();
+    const result = await client.listOrders({ $filter: filter, $top: top, $skip: skip });
+    return jsonResponse(result);
+  }
+);
+
+server.tool(
+  "create_quote",
+  "Create a quote/offer for a customer.",
+  {
+    customerId: z.string().describe("Customer ID (GUID)"),
+    rows: z.array(z.object({
+      text: z.string().describe("Line item description"),
+      quantity: z.number().describe("Quantity"),
+      unitPrice: z.number().describe("Unit price"),
+      articleId: z.string().optional().describe("Article ID"),
+    })).describe("Quote line items"),
+    quoteDate: z.string().optional().describe("Quote date (YYYY-MM-DD)"),
+    expirationDate: z.string().optional().describe("Expiry date (YYYY-MM-DD)"),
+    ourReference: z.string().optional().describe("Your reference"),
+    yourReference: z.string().optional().describe("Customer's reference"),
+  },
+  async ({ customerId, rows, quoteDate, expirationDate, ourReference, yourReference }) => {
+    const client = getClient();
+    const result = await client.createQuote({
+      CustomerId: customerId,
+      Rows: rows.map((r) => ({
+        Text: r.text,
+        Quantity: r.quantity,
+        UnitPrice: r.unitPrice,
+        ArticleId: r.articleId,
+      })),
+      QuoteDate: quoteDate,
+      ExpirationDate: expirationDate,
+      OurReference: ourReference,
+      YourReference: yourReference,
+    });
+    return jsonResponse(result);
+  }
+);
+
+// ── Start server ──────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});

package/src/visma-client.ts

@@ -0,0 +1,244 @@
+/**
+ * Visma eAccounting REST API client.
+ * API docs: https://eaccountingapi.vismaonline.com/swagger/ui/index
+ * Production: https://eaccountingapi.vismaonline.com/v2
+ */
+
+const BASE_URL = "https://eaccountingapi.vismaonline.com/v2";
+
+interface VismaConfig {
+  accessToken: string;
+}
+
+export class VismaClient {
+  private accessToken: string;
+
+  constructor(config: VismaConfig) {
+    this.accessToken = config.accessToken;
+  }
+
+  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 [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== "") {
+          url.searchParams.set(key, value);
+        }
+      }
+    }
+
+    const headers: Record<string, string> = {
+      Authorization: `Bearer ${this.accessToken}`,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+    };
+
+    const response = await fetch(url.toString(), {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Visma API error ${response.status}: ${errorText}`);
+    }
+
+    return response.json() as Promise<T>;
+  }
+
+  // ── Invoices ──────────────────────────────────────────────
+
+  async listCustomerInvoices(params?: {
+    $filter?: string;
+    $top?: string;
+    $skip?: string;
+  }) {
+    return this.request<unknown>("GET", "/customerinvoices", undefined, params);
+  }
+
+  async getCustomerInvoice(id: string) {
+    return this.request<unknown>("GET", `/customerinvoices/${id}`);
+  }
+
+  async createCustomerInvoice(invoice: {
+    CustomerId: string;
+    Rows: Array<{
+      ArticleId?: string;
+      Text?: string;
+      Quantity?: number;
+      UnitPrice?: number;
+      AccountNumber?: number;
+    }>;
+    DueDate?: string;
+    InvoiceDate?: string;
+    CurrencyCode?: string;
+    YourReference?: string;
+    OurReference?: string;
+  }) {
+    return this.request<unknown>("POST", "/customerinvoices", invoice);
+  }
+
+  async sendCustomerInvoice(id: string) {
+    return this.request<unknown>(
+      "POST",
+      `/customerinvoices/${id}/send`,
+      { SendType: 1 } // 1 = Email
+    );
+  }
+
+  async listCustomerInvoicePayments(params?: {
+    $filter?: string;
+    $top?: string;
+    $skip?: string;
+  }) {
+    return this.request<unknown>(
+      "GET",
+      "/customerinvoicepayments",
+      undefined,
+      params
+    );
+  }
+
+  // ── Customers ─────────────────────────────────────────────
+
+  async listCustomers(params?: {
+    $filter?: string;
+    $top?: string;
+    $skip?: string;
+  }) {
+    return this.request<unknown>("GET", "/customers", undefined, params);
+  }
+
+  async getCustomer(id: string) {
+    return this.request<unknown>("GET", `/customers/${id}`);
+  }
+
+  async createCustomer(customer: {
+    Name: string;
+    EmailAddress?: string;
+    CorporateIdentityNumber?: string;
+    Telephone?: string;
+    Address1?: string;
+    ZipCode?: string;
+    City?: string;
+    CountryCode?: string;
+    CurrencyCode?: string;
+  }) {
+    return this.request<unknown>("POST", "/customers", customer);
+  }
+
+  // ── Suppliers & Expenses ──────────────────────────────────
+
+  async listSupplierInvoices(params?: {
+    $filter?: string;
+    $top?: string;
+    $skip?: string;
+  }) {
+    return this.request<unknown>(
+      "GET",
+      "/supplierinvoices",
+      undefined,
+      params
+    );
+  }
+
+  async getSupplier(id: string) {
+    return this.request<unknown>("GET", `/suppliers/${id}`);
+  }
+
+  async createSupplierInvoice(invoice: {
+    SupplierId: string;
+    InvoiceDate?: string;
+    DueDate?: string;
+    TotalAmount?: number;
+    Rows: Array<{
+      AccountNumber: number;
+      DebitAmount?: number;
+      CreditAmount?: number;
+    }>;
+  }) {
+    return this.request<unknown>("POST", "/supplierinvoices", invoice);
+  }
+
+  // ── Accounting ────────────────────────────────────────────
+
+  async listVouchers(params?: {
+    $filter?: string;
+    $top?: string;
+    $skip?: string;
+  }) {
+    return this.request<unknown>("GET", "/vouchers", undefined, params);
+  }
+
+  async createVoucher(voucher: {
+    Description: string;
+    VoucherDate: string;
+    VoucherSeriesId?: string;
+    Rows: Array<{
+      AccountNumber: number;
+      DebitAmount?: number;
+      CreditAmount?: number;
+      Description?: string;
+    }>;
+  }) {
+    return this.request<unknown>("POST", "/vouchers", voucher);
+  }
+
+  async listAccounts(params?: {
+    $filter?: string;
+    $top?: string;
+    $skip?: string;
+  }) {
+    return this.request<unknown>("GET", "/accounts", undefined, params);
+  }
+
+  async listFiscalYears() {
+    return this.request<unknown>("GET", "/fiscalyears");
+  }
+
+  // ── Reports & Analytics ───────────────────────────────────
+
+  async getCompanyInfo() {
+    return this.request<unknown>("GET", "/companysettings");
+  }
+
+  async listProjects(params?: { $top?: string; $skip?: string }) {
+    return this.request<unknown>("GET", "/projects", undefined, params);
+  }
+
+  async listCostCenters(params?: { $top?: string; $skip?: string }) {
+    return this.request<unknown>("GET", "/costcenters", undefined, params);
+  }
+
+  // ── Orders & Quotes ───────────────────────────────────────
+
+  async listOrders(params?: {
+    $filter?: string;
+    $top?: string;
+    $skip?: string;
+  }) {
+    return this.request<unknown>("GET", "/orders", undefined, params);
+  }
+
+  async createQuote(quote: {
+    CustomerId: string;
+    Rows: Array<{
+      ArticleId?: string;
+      Text?: string;
+      Quantity?: number;
+      UnitPrice?: number;
+    }>;
+    QuoteDate?: string;
+    ExpirationDate?: string;
+    YourReference?: string;
+    OurReference?: string;
+  }) {
+    return this.request<unknown>("POST", "/quotes", quote);
+  }
+}

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/**/*"]
+}