Yuki Mcp MCP Server

A Model Context Protocol (MCP) server that connects AI agents to Yuki accounting via Yuki's SOAP API.

Local serverstdioMIT

What is the Yuki Mcp Server?

Yuki Mcp is an MCP project maintained in the codemill-solutions/yuki-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that connects AI agents to Yuki accounting via Yuki's SOAP API”. Read the project documentation for the complete scope.

Installation

The documented npm package is @codemill-solutions/yuki-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares YUKI_API_KEY, YUKI_DOMAIN_ID, YUKI_REGION. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_administrationsList all administrations (companies) for this API key. Run this first to find the correct administrationId.
get_administration_idLook up an administration's GUID by its exact name. Useful when you know the name but not the GUID.
reload_keysRe-read the administrationId → apiKey JSON file (including per-administration region overrides) from its configured location without restarting the server.…
search_relationssearchValue, searchOption?, active?, pageNumber?
upsert_contactfullName, contactCode?, contactType?, …
get_sales_invoicesdateOutstanding?, sortOrder?, includeBankTransactions?
process_sales_invoicereference, subject, date, dueDate, contact, lines
get_missing_invoicestypes?
get_purchase_invoicesdateOutstanding?, sortOrder?, includeBankTransactions?
process_purchase_invoicedate, invoiceAmount, invoiceVatAmount, contact, lines
get_transactionsglAccountCode, startDate, endDate
get_transaction_detailsreference
process_journalsubject, entries[]
get_gl_accountsdate?
get_gl_accounts_fiscaldate?
get_net_revenuestartDate, endDate, fiscal?
get_gl_account_scheme—
get_period_tableyearId
get_gl_transactions_detailedstartDate, endDate, glAccountCode?, financialMode?
get_transaction_documenttransactionId
get_start_balancesyearId, financialMode?
upload_documentfileName, dataBase64, folder?, amount?
upload_document_from_pathfilePath, fileName?, folder?, amount?
get_document_folders—
list_documentsfolderId
search_documentssearchText
get_documentdocumentId
download_documentdocumentId
get_cost_categories—
get_workflowadministrationId?
get_outstanding_questionsadministrationId?

How to install the Yuki Mcp Server

{
  "mcpServers": {
    "yuki": {
      "command": "npx",
      "args": [
        "-y",
        "@codemill-solutions/yuki-mcp"
      ],
      "env": {
        "YUKI_API_KEY": "YOUR_YUKI_API_KEY",
        "YUKI_DOMAIN_ID": "your-administration-guid-here",
        "YUKI_REGION": "nl"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
YUKI_API_KEYDeclared in the maintainer’s client configuration.Optional
YUKI_DOMAIN_IDDeclared in the maintainer’s client configuration.Optional
YUKI_REGIONDeclared in the maintainer’s client configuration.Yes