e-conomic-mcp-server

Perfect for anyone who, like me, is more geek than bookkeeper. Finally there is a bit of fun in bookkeeping. Who would have thought.

Getting started

Install dependencies:

npm install

Run the server:

npm start

Environment variables

The server reads e-conomic credentials from the environment:

ECONOMIC_APP_SECRET_TOKEN (required)
ECONOMIC_AGREEMENT_GRANT_TOKEN (required)
ECONOMIC_BASE_URL (optional, defaults to https://restapi.e-conomic.com)
ECONOMIC_DEBUG (optional, set to true to emit JSON debug logs to stderr)

You'll find all the information on both tokens you need to get started here. It's a bit complex but not as boring and annoying as it looks like by first glimpse. Pinky promise!

Recommended ways to supply tokens

Local development: keep secrets in .env and run npm start from the repo root so dotenv loads them.
Desktop MCP clients: either start the server from a shell that has .env loaded, or pass env variables in the client config if you want the client to spawn the server for you.
CI/shared environments: use your secret manager (GitHub Actions secrets, etc.) and inject env vars at runtime. Do not commit .env.

Tools

Tool list:

Connectivity: hello
Customers: list_customers, get_customer, update_customer
Products: list_products, upsert_product
Draft invoices: list_invoice_drafts, get_invoice_draft, create_invoice_draft, update_invoice_draft, book_invoice_draft
Booked invoices: list_booked_invoices, get_booked_invoice, download_invoice_pdf
Reference data: list_payment_terms, list_customer_groups, list_vat_zones

Tool reference

| Category | Tool | Purpose | Arguments | Returns / Notes | | --- | --- | --- | --- | --- | | Connectivity | hello | Sanity check to confirm the server is reachable. | { "name": "YourName" } | Greeting text. | | Customers | list_customers | List customers with pagination. | { "pageSize": number, "page": number } | Paginated customer collection. | | Customers | get_customer | Fetch one customer by customer number. | { "customerNumber": number } | Customer details. | | Customers | update_customer | Update customer fields. | { "customerNumber": number, ...fields } | Updated customer object. | | Products | list_products | List products with pagination. | { "pageSize": number, "page": number } | Paginated product collection. | | Products | upsert_product | Create or update a product. | { "productNumber": string, "name": string, "salesPrice": number, "productGroupNumber": number, ...optionalFields } | Product object. productGroupNumber is required on create. | | Draft invoices | list_invoice_drafts | List draft invoices with pagination. | { "pageSize": number, "page": number } | Paginated draft collection. | | Draft invoices | get_invoice_draft | Fetch a draft invoice. | { "draftInvoiceNumber": number } | Draft invoice details. | | Draft invoices | create_invoice_draft | Create a new draft invoice. | { "customerNumber": number, "currency": "DKK", "date": "YYYY-MM-DD", "lines": [...], "createCustomerIfMissing": boolean, "newCustomer": {...} } | Created draft. If a line omits productNumber, it defaults to "1". If createCustomerIfMissing is true and the customer does not exist, a new customer is created from newCustomer. | | Draft invoices | update_invoice_draft | Update a draft invoice. | { "draftInvoiceNumber": number, ...fields } | Updated draft invoice. | | Draft invoices | book_invoice_draft | Book a draft into a booked invoice. | { "draftInvoiceNumber": number } | Booked invoice payload. | | Booked invoices | list_booked_invoices | List booked invoices with pagination. | { "pageSize": number, "page": number } | Paginated booked invoice collection. | | Booked invoices | get_booked_invoice | Fetch a booked invoice. | { "bookedInvoiceNumber": number } | Booked invoice details. | | Booked invoices | download_invoice_pdf | Download a booked invoice PDF. | { "bookedInvoiceNumber": number } | { "base64": "..." }. | | Reference data | list_payment_terms | List payment terms. | { "pageSize": number, "page": number } | Payment terms collection. | | Reference data | list_customer_groups | List customer groups. | { "pageSize": number, "page": number } | Customer groups collection. | | Reference data | list_vat_zones | List VAT zones. | { "pageSize": number, "page": number } | VAT zones collection. |

MCP client setup

Claude Desktop

Add an MCP server entry to your Claude Desktop config file and restart Claude Desktop:

{
  "mcpServers": {
    "e-conomic": {
      "command": "node",
      "args": ["/absolute/path/to/e-conomic-mcp-server/src/server.js"],
      "env": {
        "ECONOMIC_APP_SECRET_TOKEN": "your_token",
        "ECONOMIC_AGREEMENT_GRANT_TOKEN": "your_token",
        "ECONOMIC_BASE_URL": "https://restapi.e-conomic.com"
      }
    }
  }
}

Common config locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Claude Code

Add the MCP server via Claude Code:

claude mcp add-json e-conomic '{
  "type": "stdio",
  "command": "node",
  "args": ["/absolute/path/to/e-conomic-mcp-server/src/server.js"],
  "env": {
    "ECONOMIC_APP_SECRET_TOKEN": "...",
    "ECONOMIC_AGREEMENT_GRANT_TOKEN": "...",
    "ECONOMIC_BASE_URL": "https://restapi.e-conomic.com"
  }
}'

Use --scope project to write a shared .mcp.json file in the repo, or --scope user to make it global for your user.

Codex CLI (OpenAI)

Add the MCP server using Codex CLI:

codex mcp add e-conomic --env ECONOMIC_APP_SECRET_TOKEN=... \
  --env ECONOMIC_AGREEMENT_GRANT_TOKEN=... \
  --env ECONOMIC_BASE_URL=https://restapi.e-conomic.com \
  -- node /absolute/path/to/e-conomic-mcp-server/src/server.js

Codex stores MCP configuration in ~/.codex/config.toml if you prefer to edit it directly.

Gemini CLI

Add to your Gemini CLI settings (user or project settings):

{
  "mcpServers": {
    "e-conomic": {
      "command": "node",
      "args": ["/absolute/path/to/e-conomic-mcp-server/src/server.js"],
      "env": {
        "ECONOMIC_APP_SECRET_TOKEN": "your_token",
        "ECONOMIC_AGREEMENT_GRANT_TOKEN": "your_token",
        "ECONOMIC_BASE_URL": "https://restapi.e-conomic.com"
      }
    }
  }
}

Settings files are located at ~/.gemini/settings.json (user) or <project>/.gemini/settings.json (project). System-wide settings live under /etc/gemini-cli/settings.json (Linux), C:\\ProgramData\\gemini-cli\\settings.json (Windows), or /Library/Application Support/GeminiCli/settings.json (macOS).

License

MIT License. See LICENSE for details.

e-conomic MCP Server