Connector guide8-minute read30 MCP tools7 languages

How to Connect Moss to Claude via MCP

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.

HCBy HelpCode teamUpdated 8 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Moss

Moss

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates, payment terms, cost centres and other dimensions, users and teams. Can create suppliers, dimensions and dimension items; it cannot pay or approve anything.

tools

30

Region

DE

Category

Finance

Authentication

OAuth 2.0

Required env vars

MOSS_KEY_IDMOSS_SECRET_KEY
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the Moss in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.

Summary

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.

Try asking

Example prompts for Moss

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Moss · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Moss, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Moss + Claude

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

MOSS_KEY_ID, MOSS_SECRET_KEY

Step 1 — Get credentials

Setting up takes about 5 minutes. You need a Moss admin, and the Moss mobile app to confirm the new key.

  1. Sign in to Moss as an admin and open Settings, Company Settings, API Keys (also shown as Settings, Platform, API Keys).
  2. Click Generate API Key and confirm in the Moss mobile app.
  3. Copy the Key ID (starts with kid_) into MOSS_KEY_ID and the Secret Key (starts with sk_) into MOSS_SECRET_KEY. The secret is shown once; generate a new key if it is lost.
  4. Install the connector and run moss_list_expenses: it returns your latest expenses and confirms the key.

The connector exchanges the key for a one-hour token at Moss's /oauth2/token (client credentials) and renews it by itself. It asks for the write scope, which includes read, because the create and update tools need it. If the AI should only read, switch those tools off.

What it reads: expenses (card transactions, invoices and reimbursements) with their line items, net, VAT and gross amounts, expense account and VAT rate per line, status, export status and supplier; the files attached to expenses (receipts, invoice PDFs), listed with moss_search_files and handed over as an attachment by moss_download_file; the Moss bank accounts (wallets) with funding type, currency and status, the balance and available balance of each, and bank transactions for a booking date range (card purchases and refunds, payouts, withdrawals, top-ups, repayments, with booking and value date, counterparty and fees); suppliers with bank details, VAT id, payment term and default booking; expense accounts with account numbers; VAT rates; payment terms with their due date and discount rules; accounting dimensions such as cost centres, cost carriers and projects with their items; users with team, manager and roles; teams and departments.

Filters: expenses filter by type (CARD_TRANSACTION, INVOICE, REIMBURSEMENT), status (for example SUBMITTED, APPROVED, FLAGGED, REJECTED, REVIEWED, VERIFIED, COMPLETED), export status (NOT_EXPORTED, READY_FOR_EXPORT, EXPORT_PENDING, EXPORTED, EXPORT_FAILED), creation date, expense date or last update, and sort by status, creation time, home amount or expense time. Bank transactions always need a booking date range. Files of line items are only listed when the line ids are passed as well.

What it writes: moss_create_supplier, moss_create_dimension, moss_update_dimension, moss_create_dimension_item (for example a new cost centre) and moss_update_dimension_item change master data used for booking. They are on at install; the AI shows you what it will create or change and waits for your yes, and it passes external_user_id (the person who asked) so Moss can trace the change. Suppliers and dimension items can be set ACTIVE or DEACTIVATED; deleting is not offered. A dimension item update always needs name and status, so the AI sends the current values for what should stay. Creating more than the default dimensions needs the Moss Multiple Dimensions module.

Switched off at install: moss_update_supplier, because it can replace the IBAN that Moss pays the supplier's invoices to. An administrator turns it on deliberately, and the AI then shows the old and new values before calling it.

Amounts and dates: amounts are objects with a decimal string amount and a currency; homeAmount is in the company's home currency. Dates are YYYY-MM-DD, timestamps ISO 8601 in UTC. Ids are UUIDs.

Limits: lists return up to 100 items per page (default 50); the AI calls the next page while meta.pagination.hasMore is true. Id filters take up to 100 ids. Moss allows 180 reads and 20 writes per minute per organisation.

Common errors: 401 means the key was revoked or the token could not be issued: check MOSS_KEY_ID and MOSS_SECRET_KEY. 402 means a Moss module is not booked, for example Multiple Dimensions. 403 means the token lacks the scope. 409 means the record is managed by an active accounting integration. 422 means a referenced id (expense account, VAT rate, payment term, team) does not exist or is inactive. 429 means the rate limit is used up: wait for Retry-After.

The connector cannot pay, approve, export or delete anything, and it does not create expenses or upload receipts: the Moss Public API offers no such call.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Claude

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Recommended path: works on claude.ai web without editing any config file.

  1. In Claude, open Customize → Connectors.
  2. Click +, then Add custom connector.
  3. Enter a name, e.g. Moss, and the remote MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Add.
  4. Click Connect and sign in to AnythingMCP (OAuth) to allow access.

All tools below appear in your chat: start typing prompts.

Available tools

ToolWhat it does
moss_list_expensesList expenses (card transactions, invoices and reimbursements) with their line items, amounts in original and home currency, status, export…
moss_search_filesList the files (receipts, invoice PDFs) attached directly to the given expenses: id, name, original name, size and upload time
moss_download_fileDownload one file attached to an expense (receipt or invoice, usually a PDF or image) by its id from moss_search_files
moss_list_expense_accountsList expense accounts (the accounting sub-categories booked on expense lines): id, name, account number and status
moss_get_expense_accountGet one expense account by id: name, account number and status
moss_list_dimensionsList the accounting dimensions of the organisation (e.g. cost centre, cost carrier, project; at most 50): id, name, ERP name and id, status
moss_get_dimensionGet one accounting dimension by id: name, ERP name, ERP id and status
moss_list_dimension_itemsList the items (values) of one dimension, e.g. the cost centres: id, name, code and status
moss_get_dimension_itemGet one dimension item (e.g. a cost centre) by id: name, code and status
moss_list_suppliersList suppliers: id, name, supplier number (code), status, currency, VAT id, bank details, default payment method, payment term and default…
moss_get_supplierGet one supplier by id (e.g. the supplierId of an expense) with bank details, VAT id and defaults
moss_list_payment_termsList payment terms: id, number, description, status and the due date rules (days, discounts)
moss_get_payment_termGet one payment term by id, e.g. the paymentTermId of a supplier
moss_list_tax_ratesList VAT rates: id, name, code, rate and status
moss_get_tax_rateGet one VAT rate by id (taxRateId of an expense line): name, code, rate and status
moss_list_usersList the users of the organisation: id, name, e-mail, team, manager, roles and status. createdBy of an expense is a user id
moss_get_userGet one user by id: name, e-mail, team, manager, roles and status
moss_list_teamsList teams: id, name, department and status
moss_get_teamGet one team by id (teamId of a user or default team of a supplier): name, department and status
moss_list_departmentsList the departments of the organisation: id and name
moss_get_departmentGet one department by id (the department of a team) with its name
moss_list_bank_accountsList the Moss bank accounts (wallets) of the organisation: id, funding type (CREDIT or DEBIT), currency and status (ACTIVE or CLOSED)
moss_get_bank_account_balanceGet the current balance of one Moss bank account: balance (ledger) and availableBalance (what can still be spent, lower when transactions…
moss_search_bank_transactionsSearch the money movements of Moss wallets by booking date: card purchases and refunds, payouts, withdrawals, top-ups and repayments, with…
moss_create_supplierCreate a supplier in Moss with name, supplier number, currency, VAT id, bank details, default payment method, payment term and default…
moss_update_supplierChange fields of an existing supplier; only the fields you send change
moss_create_dimensionCreate an accounting dimension (e.g
moss_update_dimensionRename a dimension in Moss and set its name in the accounting system
moss_create_dimension_itemAdd an item to a dimension, e.g. a new cost centre or project with its name and code
moss_update_dimension_itemRename a dimension item, change its code, or activate or deactivate it

Example prompts

  • "List the card transactions of last month that are still NOT_EXPORTED, with amount, supplier and expense account."
  • "What is the available balance of each of our Moss wallets right now?"
  • "Show me the receipt attached to the Moss expense of 249.90 EUR from 14 October."
  • "Sum our invoices of the third quarter by supplier and VAT rate."
  • "Create the cost centre 4300 Marketing Events in our cost centre dimension. Show me what you will create first."

FAQ

Does it work with Claude Code as well as Claude Desktop? Yes, point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Next steps

Was this guide helpful?

Your Moss agent is one click away.

Install the connector, paste the key, prompt Claude. Free for 7 days, no credit card.

Related guides

Connectors

How to Connect Moss to Microsoft Copilot via MCP

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.

Connectors

How to Connect Moss to ChatGPT via MCP

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.

Connectors

How to Connect Moss to Cursor via MCP

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.

Connectors

How to Connect Moss to Gemini via MCP

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.

Connectors

How to Connect Moss to Meta Muse via MCP

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.

Connectors

Moss to MCP: Expenses, Receipts, Wallets and Suppliers in any AI Agent

Moss spend management (Germany and Europe): expenses from cards, invoices and reimbursements with line items and receipts, wallet balances and bank transactions, suppliers, expense accounts, VAT rates and cost centres. Creates suppliers and dimension items; it cannot pay or approve anything.