Skip to content
Back to search

upinvoice

MarketplaceWorks with Claude CodeGitHub

UpInvoice skills for AI agents: extract invoices and orders into structured JSON.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/upinvoice--skills/badge.svg)](/listings/upinvoice--skills)

HTML

<a href="/listings/upinvoice--skills"><img src="/api/listings/upinvoice--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

claude plugin marketplace add upinvoice/skills
claude plugin install upinvoice-api@upinvoice

Inside a Claude Code session you can also run `/plugin marketplace add upinvoice/skills` and pick `upinvoice-api` from `/plugin`.

Claude.ai and Claude Desktop

1. Download this repository as a ZIP and extract it. 2. Zip the `skills/upinvoice-api` folder on its own. 3. Upload it in **Settings > Capabilities > Skills**.

Other agents (Cursor, Codex, Copilot, Windsurf and more)

npx skills add upinvoice/skills

Or copy `skills/upinvoice-api/` into the skills folder your agent reads.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "upinvoice",
  3. "owner": {
  4. "name": "UpInvoice",
  5. "url": "https://upinvoice.eu"
  6. },
  7. "description": "UpInvoice skills for AI agents: extract invoices and orders into structured JSON.",
  8. "plugins": [
  9. {
  10. "name": "upinvoice-api",
  11. "description": "Extract supplier invoices, purchase orders and customer orders (PDF or image) with the UpInvoice API.",
  12. "source": "./",
  13. "strict": false,
  14. "skills": ["./skills/upinvoice-api"]
  15. }
  16. ]
  17. }
README.md · README · 113 lines
  1. # UpInvoice skills
  2. Agent skills for [UpInvoice](https://upinvoice.eu), the AI extraction service that turns a PDF, scan or phone photo of an invoice or order into structured JSON: supplier or customer, references, dates, totals, VAT and product lines. Lines are checked against the document totals before the response is returned.
  3. | Skill | What it does |
  4. |-------|--------------|
  5. | [`upinvoice-api`](skills/upinvoice-api/SKILL.md) | Teaches an agent to call the UpInvoice REST API for supplier invoices, supplier orders and customer orders, handle errors and idempotency, and map the result into an ERP, accounting tool, database or spreadsheet. Includes a standard-library Python helper script. |
  6. The skill follows the open [Agent Skills](https://agentskills.io) format, so it works in any agent that supports `SKILL.md`.
  7. ## Install
  8. ### Claude Code
  9. ```bash
  10. claude plugin marketplace add upinvoice/skills
  11. claude plugin install upinvoice-api@upinvoice
  12. ```
  13. Inside a Claude Code session you can also run `/plugin marketplace add upinvoice/skills` and pick `upinvoice-api` from `/plugin`.
  14. ### Claude.ai and Claude Desktop
  15. 1. Download this repository as a ZIP and extract it.
  16. 2. Zip the `skills/upinvoice-api` folder on its own.
  17. 3. Upload it in **Settings > Capabilities > Skills**.
  18. ### Other agents (Cursor, Codex, Copilot, Windsurf and more)
  19. ```bash
  20. npx skills add upinvoice/skills
  21. ```
  22. Or copy `skills/upinvoice-api/` into the skills folder your agent reads.
  23. ## MCP server
  24. If you want an assistant to extract documents directly instead of writing integration code, connect it to the remote MCP server `https://upinvoice.eu/mcp` (streamable HTTP, header `Authorization: Bearer <key>`). Tools: `process_document` (1 credit per document) and `check_account` (free).
  25. **Claude Code**
  26. ```bash
  27. claude mcp add --transport http upinvoice https://upinvoice.eu/mcp --header "Authorization: Bearer YOUR_API_KEY"
  28. ```
  29. **Cursor** (`~/.cursor/mcp.json`)
  30. ```json
  31. {
  32. "mcpServers": {
  33. "upinvoice": {
  34. "url": "https://upinvoice.eu/mcp",
  35. "headers": { "Authorization": "Bearer YOUR_API_KEY" }
  36. }
  37. }
  38. }
  39. ```
  40. **VS Code** (`.vscode/mcp.json`)
  41. ```json
  42. {
  43. "servers": {
  44. "upinvoice": {
  45. "type": "http",
  46. "url": "https://upinvoice.eu/mcp",
  47. "headers": { "Authorization": "Bearer YOUR_API_KEY" }
  48. }
  49. }
  50. }
  51. ```
  52. **Claude Desktop** (`claude_desktop_config.json`)
  53. ```json
  54. {
  55. "mcpServers": {
  56. "upinvoice": {
  57. "command": "npx",
  58. "args": ["-y", "mcp-remote", "https://upinvoice.eu/mcp",
  59. "--header", "Authorization: Bearer ${UPINVOICE_API_KEY}"],
  60. "env": { "UPINVOICE_API_KEY": "YOUR_API_KEY" }
  61. }
  62. }
  63. }
  64. ```
  65. More clients: https://upinvoice.eu/developers/mcp
  66. ## Requirements
  67. - An UpInvoice API key. Create one at https://upinvoice.eu/api/tokens (sign-up is free) and expose it as `UPINVOICE_API_KEY`. Never commit it.
  68. - Network access to `upinvoice.eu`.
  69. - Python 3 for the optional helper script.
  70. ## Pricing
  71. Each processed document costs one credit. Credits come with a monthly or yearly plan, or as extra credit packs, and every new account gets 10 free documents. Errors and idempotent replays are not charged. See https://upinvoice.eu/prices.
  72. ## Documentation
  73. - Developer docs: https://upinvoice.eu/developers
  74. - MCP setup: https://upinvoice.eu/developers/mcp
  75. - OpenAPI 3.1 reference: https://upinvoice.eu/openapi.yaml
  76. - Dolibarr users: the free [UpInvoice module for Dolibarr](https://github.com/upinvoice/module_upinvoice) already calls this API and creates the documents, no custom code needed.
  77. ## Contributing
  78. The skill content is maintained by the UpInvoice team. Issues and suggestions are welcome; please open an issue before sending a pull request.
  79. ## License
  80. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.