| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 4427 |
| Technical Name |
llm_tool_account |
| License | LGPL-3 |
| Website | https://github.com/apexive/odoo-llm |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 4427 |
| Technical Name |
llm_tool_account |
| License | LGPL-3 |
| Website | https://github.com/apexive/odoo-llm |
Talk to Your Books
with AI
18 specialized accounting tools for AI assistants. Trial balance, tax reports, journal entries, reconciliation, and more - all through natural language.
Designed for CPAs, bookkeepers, and finance teams who use AI assistants daily
Why Accounting Needs Specialized Tools
Generic CRUD is not enough for financial operations
While the MCP Server already lets AI read and write any Odoo record, accounting requires domain-specific intelligence. Trial balances need initial balance logic (balance sheet vs. P&L). Tax reports aggregate by tax line. Reconciliation matches debits and credits. This module provides 18 purpose-built tools that understand accounting rules, so your AI assistant can operate like a trained bookkeeper.
What Makes This Different
Accounting Logic Built In
Initial balances, fiscal year boundaries, BS vs P&L treatment, aging buckets - all handled automatically. No prompting gymnastics needed.
CPA-Friendly Language
Say "invoice", "bill", "receivable", or "bank" - the tools understand accounting terminology and map it to Odoo's internal types.
Safe by Default
Read-only tools are marked as safe. Destructive operations (posting, payments, lock dates) require explicit confirmation from the AI host.
18 Purpose-Built Accounting Tools
Organized by CPA workflow: data entry, lookups, reporting, reconciliation, and period close
Data Entry (5 tools)
account_create_move
Create journal entries, invoices, bills, credit notes, and refunds. Resolves accounts by code, partners by name, taxes by label.
destructiveaccount_post_moves
Post draft moves by reference or by filter criteria. Validates lock dates and balanced entries.
destructiveaccount_unpost_moves
Reset posted moves back to draft. Checks lock dates and handles unreconciliation automatically.
destructiveaccount_reverse_move
Create and post a reversal entry with reason tracking. Uses Odoo's native reversal logic.
destructiveaccount_register_payment
Register payments against invoices/bills or create direct payments. Handles partial and group payments.
destructiveLookups (3 tools)
account_find_moves
Find journal entries by reference, partner, type, state, date range, amount, or payment status.
read-onlyaccount_find_accounts
Search chart of accounts by code pattern, name, or type shortcut (receivable, income, expense, etc.).
read-onlyaccount_find_journals
Look up journals by code, name, or type (sale, purchase, bank, cash, general).
read-onlyReports & Balances (5 tools)
account_get_balances
Trial balance with flexible grouping (account, partner, journal, currency). Proper initial balance for BS vs P&L accounts.
read-onlyaccount_get_tax_balances
Tax balance summary grouped by tax, partner, or journal. Base amount and tax amount for VAT/GST reporting.
read-onlyaccount_get_ledger
General ledger with running balance, pagination, and reconciliation status. Includes initial balance row.
read-onlyaccount_get_profit_and_loss
P&L report with optional comparison period and variance analysis (amount and percentage).
read-onlyaccount_get_cash_position
Current cash snapshot: bank balances, outstanding incoming/outgoing payments, and projected cash.
read-onlyReconciliation (3 tools)
account_get_unreconciled
List unreconciled items filtered by type: bank, invoices, bills, payments, or all.
read-onlyaccount_reconcile
Reconcile journal items with optional write-off account. Supports partial reconciliation.
destructiveaccount_suggest_matches
Find matching debit/credit pairs by amount, partner, and reference for quick reconciliation.
read-onlyPeriod Close (2 tools)
account_check_period
Pre-close checklist: draft moves, unreconciled bank items, open receivable/payable items, and current lock dates.
read-onlyaccount_set_lock_date
Set fiscal year, tax, or period lock dates. Prevents accidental changes to closed periods.
destructiveJust Ask in Plain English
Your AI assistant understands accounting terminology and handles complex operations instantly
Trial Balance
Get balances for any period with proper initial balance logic
"Show me the trial balance for Q1 2025, grouped by account type"
Journal Entries
Create invoices and entries using account codes and partner names
"Create an invoice for Acme Corp: 10 hours of consulting at $150/hr"
Tax Reporting
Aggregate tax balances by tax, partner, or journal
"What are the tax balances for 2025, broken down by partner?"
Reconciliation
Find unreconciled items and match them automatically
"Show unreconciled bank items and suggest matches"
Smart Account Resolution
Say "receivable", "bank", "income", or use account codes like "111101" or patterns like "6%" - the tools understand all of these and resolve them automatically.
Period Close Workflow
Run pre-close checklists, verify all entries are posted, check reconciliation status, and set lock dates - all through conversational commands.
Why Finance Teams Love This
Because it understands accounting, not just data
Instant Reports
Get a trial balance, P&L, or tax summary in seconds. No more navigating through menus and setting filters.
Batch Operations
Post 50 draft entries, pay multiple invoices, or reconcile bank items - all with a single natural language command.
Audit Safe
All operations use Odoo's native methods and respect lock dates, access controls, and validation rules. Full audit trail preserved.
Quick Setup
Install the module, and all 18 tools are immediately available to any connected MCP client
Install LLM MCP Server
The base MCP Server module provides the connection layer between Odoo and AI clients.
Install LLM Tool Account
Search "LLM Tool Account" in Apps and click Install. All 18 accounting tools register automatically.
Start Asking Questions
Your AI assistant now has full accounting capabilities. Try: "Show me the trial balance for this quarter"
Zero Configuration Required
Tools auto-register on install. No XML, no manual setup, no restart needed.
Extend With Your Own Tools
Add custom accounting tools in minutes using the same pattern
Inherit the Mixin
Your tools get account resolution, partner lookup, journal matching, and fiscal year logic for free.
from odoo.addons.llm_tool.decorators import llm_tool
class MyAccountTools(models.Model):
_name = "account.tool.custom"
_inherit = "account.tool.mixin"
@llm_tool(read_only_hint=True)
def get_aged_receivables(
self, as_of_date: str
) -> dict:
"""Get aged receivable report"""
accounts = self._resolve_accounts(
"receivable"
)
# Your logic here...
Shared mixin provides _resolve_accounts, _resolve_partner, _resolve_journal, and more
Module Architecture
Clean separation of concerns across 9 model files
Data Entry
Create, post, reverse
Lookups
Moves, accounts, journals
Reports
Balance, P&L, cash
Period Close
Check & lock
See full source on github.com/apexive/odoo-llm
github.com/apexive/odoo-llm
Enterprise-Grade Security
Built with accounting compliance and audit requirements in mind
Accountant Role Required
Tools are only accessible to users with the Accountant role (account.group_account_user). No sudo() calls - every operation runs with the user's own permissions.
Lock Date Enforcement
All write operations respect Odoo's fiscal year, tax, and period lock dates. Attempting to modify a locked period raises an error - same as the UI.
Destructive Tool Hints
Write operations are marked with destructive_hint=True. MCP clients like Claude Desktop will ask for user confirmation before executing them.
Full Audit Trail
All operations use Odoo's native methods (action_post, _reverse_moves, reconcile). Every change is logged through standard Odoo tracking and chatter.
Part of Apexive's Odoo LLM Ecosystem
Seamlessly integrates with Apexive's complete AI toolkit for Odoo
LLM MCP Server
The connection layer that exposes tools to Claude Desktop, Claude Code, Codex CLI, and other MCP clients
LLM Tool
The base framework providing the @llm_tool decorator, tool registry, and auto-registration system
LLM Tool MIS Builder
41 tools for MIS Builder reports: create KPIs, configure periods, compute reports, and analyze variances
LLM Thread
Have persistent AI conversations directly in Odoo with full context and history
LLM Assistant
Create specialized AI assistants for specific roles like sales, support, or accounting
LLM Knowledge
Turn PDFs, images, webpages, and documents into AI-searchable knowledge base
Documentation & Support
Everything you need to get started
Complete Documentation
Setup guides, tool reference, and extension tutorials included.
github.com/apexive/odoo-llm
llm_tool_account/
llm_tool, account
Open Source
Full source code available on GitHub. Contribute, customize, or learn from the implementation.
GitHub Repository:
github.com/apexive/odoo-llm
View code, report issues, or join discussions
Please log in to comment on this module