osome-accounting-skills

OSOME Accounting Skills

Agent skills for accounting and bookkeeping, powered by the OSOME MCP server.

Prerequisites

Connect the OSOME MCP server to your Claude/OpenCode environment as a Streamable HTTP MCP endpoint:

https://mcp.osome.com/mcp

The MCP endpoint handles JSON-RPC over POST /mcp. Authentication is via OAuth bearer token; MCP clients can discover OAuth metadata from /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server. Read-only tools require openid; document upload additionally requires company:documents:write.

Available Skills

Skill	Description
financial-health-check	Get a snapshot of your company's financial position
cash-flow-visibility	Understand where money is coming from and going
receivables-payables-tracker	Track who owes you and who you owe
ledger-deep-dive	Query specific transactions and accounts
corporate-structure-overview	View directors and subsidiaries
tax-compliance-snapshot	Check GST/VAT obligations and prepare for tax filing

Installation

Claude Code

Install directly from GitHub:

/plugin install github:OsomePteLtd/skills

OpenCode

Copy skills to your config directory:

git clone https://github.com/OsomePteLtd/skills.git osome-skills
cp -r osome-skills/skills/* ~/.config/opencode/skills/

Or for project-scoped installation:

cp -r osome-skills/skills/* .opencode/skills/

Manual Installation (Any Agent)

Copy skills to your agent's skills directory:

git clone https://github.com/OsomePteLtd/skills.git osome-skills

# For Claude Code
cp -r osome-skills/skills/* ~/.claude/skills/

# For OpenCode
cp -r osome-skills/skills/* ~/.config/opencode/skills/

# For any agent supporting .agents/ convention
cp -r osome-skills/skills/* ~/.agents/skills/

Usage

Once installed, skills are automatically triggered by relevant questions:

• "Am I making money?" → financial-health-check
• "Where is my money going?" → cash-flow-visibility
• "Who hasn't paid me?" → receivables-payables-tracker
• "What did I spend on software?" → ledger-deep-dive
• "Who are my directors?" → corporate-structure-overview
• "How much GST do I owe?" → tax-compliance-snapshot

MCP Tools

These skills orchestrate tools from the OSOME MCP server:

Company

• list-companies - List your companies
• get-company - Company details and fiscal year

Accounting

• get-chart-of-accounts - Chart of accounts by jurisdiction
• search-transactions - Search transactions with optional date range and limit (newest first; default 50)
• list-documents - Accounting documents (ID and name only)
• get-document - Document details (ID and name only)
• prepare-document-upload - Step 1 for document upload; returns a presigned POST target and uploadToken
• complete-document-upload - Step 3 for document upload; creates the OSOME document after bytes are uploaded to the presigned target
• get-journal-entries - Journal entries (ID, description, amount)
• get-bank-accounts - Bank accounts and balances

Document upload supports PDF, JPG/JPEG, PNG, CSV, XLS, and XLSX files up to 50 MB. Do not send file bytes or contentBase64 to MCP: upload the file directly to the presigned POST target returned by prepare-document-upload, then call complete-document-upload with the same metadata and uploadToken.

Reports

• get-balance-sheet - Balance sheet report
• get-profit-and-loss - Profit & loss statement
• get-cash-flow-statement - Cash flow statement
• get-trial-balance - Trial balance
• get-aged-payables - Accounts payable aging
• get-aged-receivables - Accounts receivable aging

Compliance

• get-corporate-subsidiaries - Subsidiary companies
• get-directors-shareholders - Directors (name, role, jurisdiction)

Multi-Jurisdiction Support

Skills work with companies in these jurisdictions:

Jurisdiction	Tax System	Currency
Singapore	GST (9%)	SGD
Hong Kong	No GST/VAT	HKD
United Kingdom	VAT (20%)	GBP
UAE	VAT (5%)	AED

License

Proprietary - OSOME Pte Ltd. See LICENSE for details.