Morning Skill

April 14, 2026 · View on GitHub

Full Morning (Green Invoice / חשבונית ירוקה) API skill for AI agents. Covers the complete API surface: expenses, file upload, classifications, clients, suppliers, items, documents (invoices, receipts, quotes), payments, business settings, and reference data. Expenses and file upload are documented with raw API patterns; all other endpoints use morning-cli as the execution layer.

This skill uses Morning's official public API (Apiary spec) — not a reverse-engineered or unofficial API.

When to Use What

Method	When
Morning UI	One-off entry, draft review, classification setup
morning-cli (this skill, sections 10–18)	Clients, suppliers, items, documents, payments, business, reference data
Raw API / Python (this skill, sections 1–9)	Expense bulk imports, file uploads with OCR, automation scripts
Morning + n8n/Make	Webhook-driven flows (e.g., auto-create expense when a file lands in Google Drive)

What's Included

Sections 1–9 — Raw API (Python)

Topic	What it covers
Authentication	Bearer token via `/account/token`, production vs sandbox base URLs
Expense Endpoints	All expense and classification endpoints in one table
Create Expense	Full request structure, document types, payment types, statuses — with Hebrew labels
File Upload (Two-Step)	Presigned S3 URL flow: create expense → get presigned URL → upload to S3 → poll for attachment
File Upload Gotchas	requests library required, field ordering, async processing (5–15s), file type limits
Upload-First Flow	Upload file → create draft (Morning runs OCR and creates draft automatically)
Search Expenses	Filtered search by date, supplier, amount, status, classification
Classifications	List all accounting classifications with codes and VAT settings
Webhooks	expense-draft/parsed, expense-file/updated, expense-draft/declined, file/infected
Common Errors	Error codes 3306, 3310, 3311, 3312 with Hebrew descriptions and fixes
Bulk Upload Pattern	Complete Python pattern for uploading many expenses with files from external sources

Sections 10–18 — morning-cli

Section	What it covers
10	morning-cli setup and routing guide
11	Clients — CRUD, search, balance, associate, merge
12	Suppliers — CRUD, search, merge
13	Documents — types, statuses, search, preview, create, download
14	Items — price list CRUD
15	Payments — tokens, charge, payment form
16	Business — profile, numbering sequences, logo/signature upload
17	Partners — partner-tier account operations
18	Reference data — currencies (live rates), countries, cities, occupations

Install

Claude Code

git clone https://github.com/D1DX/morning-skill.git
cp -r morning-skill ~/.claude/skills/morning

Or as a git submodule:

git submodule add https://github.com/D1DX/morning-skill.git path/to/skills/morning

Other AI Agents

Copy SKILL.md into your agent's prompt or knowledge directory. The skill is structured markdown — works with any LLM agent that reads reference files.

Structure

morning-skill/
└── SKILL.md    — Full API skill (18 sections: expenses + file upload via raw API; all other endpoints via morning-cli)

Key Gotcha: supplier placement

The most common error (code 3311) is placing supplier inside a data object. It must be at the root level of the expense JSON. The skill documents this and all other critical payload rules.

Sources

Sections 1–9: Verified against the Morning/Green Invoice Apiary specification and live production usage (March 2026).
Sections 10–18: Verified against live sandbox via morning-cli (April 2026).

Credits

Built by Daniel Rudaev at D1DX.