mcp

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Gecti
  • Code scan — Scanned 2 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

MCP server for AI accounting. Connect Claude, ChatGPT or Cursor to your Numina ledger.

README.md

Numina MCP: AI bookkeeping and accounting with Claude and ChatGPT

Bring your own AI to your books. The Numina MCP server connects Claude,
ChatGPT, Cursor or any other MCP client to your accounting ledger, so your AI
can answer questions about your numbers and do the bookkeeping.

Bogføring og regnskab med AI: forbind Claude eller ChatGPT til dit regnskab
i Numina.

What you get

Numina is a Danish accounting system: ledger, bank
reconciliation, invoicing, VAT returns and reports, approved by the Danish
Business Authority (Erhvervsstyrelsen). The Numina MCP server opens that
ledger to the AI assistant you already use:

  • Ask anything about your numbers. "What did we spend on software this
    year?", "Which invoices are overdue?", "Show the trial balance for Q3."
  • Let it do the work. Draft expenses, match bank lines, create contacts
    and upload receipts.
  • Stay in control. Your AI only writes drafts. Nothing is booked until you
    approve it in Numina, and every change shows who made it and why.

MCP (Model Context Protocol) is the open standard AI assistants use to connect
to other services, so the same server works with Claude, ChatGPT, Cursor and
others.

This repo has the setup steps, a reference of the tools, and skills:
step-by-step instructions your AI follows for a whole job, like booking last
month's Pleo expenses.

No Numina account yet? Create one at numina.app.

Connect

The server address is https://api.numina.app/mcp.

Claude (claude.ai / Desktop)
Settings → Connectors → Add custom connector → paste the URL → Connect.
Log in to Numina, pick the company and approve.

Claude Code

claude mcp add --transport http numina https://api.numina.app/mcp

Then run /mcp and choose Authenticate.

ChatGPT
Settings → Apps & Connectors → Advanced → turn on Developer mode, then
create a connector with the URL above and sign in to Numina.

Other clients (Cursor, VS Code, …)
Use an API key, see examples/clients.md.

You can revoke access any time in Numina under
Integrationer → API forbindelser.

Skills

Each skill is a SKILL.md file that walks your AI through one bookkeeping
job, using the Numina tools below and the other service's own connector.

Skill What your AI does
Gmail receipts Finds receipts in Gmail and gets them into Numina
Outlook receipts Finds receipts in Outlook and gets them into Numina
Pleo Drafts Pleo expenses with their receipts
Stripe Drafts Stripe payouts against the bank, with sales, VAT and fees
Google Sheets Puts your trial balance and key figures in a sheet
Move your whole history Moves every year's postings, invoices and contacts from Dinero, Billy, e-conomic or another system
Move from e-conomic Carries your e-conomic balances over as Numina's opening balance. Also holds the e-conomic API notes for moving the whole history
Move from Billy Carries your Billy balances over as Numina's opening balance
Move from Dinero Carries your Dinero balances over as Numina's opening balance

Install

  • Claude: upload the skill folder under Settings → Capabilities → Skills,
    or copy it to ~/.claude/skills/ for Claude Code.
  • ChatGPT and others: paste the SKILL.md into a project's instructions
    or the chat.

Then ask, for example: "Run the Gmail receipts skill for last month."

Tools

Read

Tool What it returns
get_company_info Company, accounting years, granted scopes
list_accounts, list_vat_codes Chart of accounts and VAT codes
get_account_balances Net movement per account per period
get_trial_balance Balances on a date
search_ledger_entries, get_transaction Booked and draft transactions
list_booked_entries Every posted entry in a period, with VAT code and bilag number, up to 1000 per call
search_bank_transactions, get_bank_transaction Bank lines and whether they're reconciled
get_bank_balances Last-synced bank balances
list_invoices, get_invoice Sales invoices
search_contacts, get_contact Customers and suppliers
search_documents, get_document Receipts and other source documents

Write (drafts only, nothing is booked)

Tool What it does
create_draft, update_draft, delete_draft Balanced draft transactions, optionally for a bank line
reconcile_bank_transaction, unlink_bank_transaction Match a bank line to a draft, or undo it
propose_booked_change Suggest a correction to a booked transaction
create_contact, update_contact Suppliers and customers
create_upload_link, set_document_ocr Upload a receipt and record what it says
resolve_review Close a review once it's fixed

Move the books (company administrators; nothing is imported until you approve it in Numina)

Tool What it does
get_migration_guide The migration format, the rules and where the old system's exports are
start_migration, get_migration, discard_migration Open the company's migration, read its state, or start over
create_migration_upload_link A link to upload the migration as one zip file
validate_migration Errors, warnings and the check against the old trial balance
get_migration_preview What will be imported: balances, unpaid invoices, every posting

create_upload_link also takes an attachment_id, to give an empty bilag
its file after a migration.

Lines are signed (positive = debit, negative = credit) and must balance to 0.
Danish VAT codes take the gross amount, reverse-charge codes the net amount.
Every write takes a short reasoning, shown on the transaction's history.

Examples

Contributing

Found a mistake or built a skill worth sharing? Open an issue or a pull request.

License

MIT. "Numina" and the Numina logo are trademarks of Numina Technologies ApS and are not covered by the license.

Yorumlar (0)

Sonuc bulunamadi