MCP ERPNEXT TOOLS

120 tools from the Mcp Erpnext MCP Server, categorised by risk level.

View the Mcp Erpnext policy →

READ TOOLS

88
erpnext_account_list List Chart of Accounts. Filterable by root_type and is_group. Fields: name, account_name, account_type, root_type, parent_account, is_group. root_t... erpnext_ar_aging Accounts Receivable Aging — stacked bar showing outstanding invoices by customer, grouped into aging buckets (0-30, 31-60, 61-90, 90+ days). Shows ... erpnext_asset_category_list List Asset Categories. Fields: name, asset_category_name. erpnext_asset_get Get a single Asset by name. Returns full details including depreciation schedule and maintenance logs. erpnext_asset_list List Fixed Assets. Filterable by status, asset_category, location, custodian. Fields: name, asset_name, asset_category, status, purchase_date, gros... erpnext_asset_maintenance_get Get a single Asset Maintenance record by name. Returns full details including maintenance tasks. erpnext_asset_maintenance_list List Asset Maintenance records. Filterable by asset_name, maintenance_status. Fields: name, asset_name, asset_category, maintenance_team, maintenan... erpnext_asset_movement_get Get a single Asset Movement by name. Returns full details including assets moved. erpnext_asset_movement_list List Asset Movements (transfers between locations/custodians). Fields: name, transaction_date, purpose, company. erpnext_attendance_list List Attendance records. Filterable by employee, date range. Fields: name, employee, employee_name, attendance_date, status. erpnext_bom_get Get a single BOM by name (e.g. BOM-ITEM-00001). Returns full document with raw materials and operations. erpnext_bom_list List Bills of Materials (BOM). Filterable by item, is_active, is_default. Fields: name, item, item_name, quantity, uom, is_active, is_default, tota... erpnext_campaign_list List CRM Campaigns. Fields: name, campaign_name, campaign_type, start_date, end_date, description. erpnext_company_list List ERPNext companies. Fields: name, abbr, default_currency, country, domain. erpnext_contact_get Get a single Contact by name. Returns all contact details. erpnext_contact_list List Contacts. Filterable by company_name, status. Fields: name, first_name, last_name, company_name, email_id, mobile_no, status. erpnext_customer_get Get a single ERPNext customer by name (ID). Returns all fields including contact details. erpnext_customer_list List ERPNext customers. Returns active customers by default. Fields: name, customer_name, customer_group, territory, email_id, disabled. erpnext_delivery_note_get Get a single Delivery Note by name (e.g. MAT-DN-00001). Returns full document with delivered items. erpnext_delivery_note_list List Delivery Notes. Filterable by customer, status, date range. Fields: name, customer, posting_date, status, total_qty, grand_total. erpnext_doc_get Get any ERPNext document by DocType and name. Useful for DocTypes not covered by dedicated tools. Returns the full document with all fields. erpnext_doc_list List any ERPNext documents by DocType. Useful for DocTypes not covered by dedicated tools. Supports field selection, filters (as JSON array), and l... erpnext_employee_get Get a single Employee by name/ID (e.g. HR-EMP-00001). Returns all fields. erpnext_employee_list List Employees. Filterable by department, status. Fields: name, employee_name, designation, department, company, status, date_of_joining. erpnext_expense_claim_list List Expense Claims. Filterable by employee, status, approval_status. Fields: name, employee, employee_name, posting_date, total_claimed_amount, st... erpnext_gross_profit Gross profit analysis — composed chart showing revenue (bars) vs margin % (line) by item or customer. Uses Sales Invoice Item for revenue and Bin v... erpnext_item_get Get a single ERPNext Item by name/item_code. Returns all fields including pricing and stock details. erpnext_item_list List ERPNext Items. Returns active items by default. Fields: name, item_code, item_name, item_group, stock_uom, is_stock_item, standard_rate. Filte... erpnext_job_card_get Get a single Job Card by name. Returns full document with time logs and material transfers. erpnext_job_card_list List Job Cards (production operations tracking). Filterable by work_order, status, operation. Fields: name, work_order, operation, status, for_quan... erpnext_journal_entry_get Get a single Journal Entry by name (e.g. JV-00001). Returns full document with accounts. erpnext_journal_entry_list List Journal Entries. Filterable by date range and voucher_type. Fields: name, voucher_type, posting_date, total_debit, total_credit, remark. erpnext_kanban_get_board Get a normalized kanban board for a supported ERPNext DocType. Supports Task, Opportunity, and Issue, with pagination and MCP App metadata. erpnext_kpi_gross_margin KPI card: estimated gross margin % based on Sales Order revenue vs valuation rate from stock (Bin). Margin = (revenue - cost) / revenue * 100. erpnext_kpi_orders KPI card: count and total value of Sales Orders created this month, with delta % vs last month. erpnext_kpi_outstanding KPI card: total outstanding receivables from submitted Sales Invoices with outstanding_amount > 0. Shows count of open invoices. erpnext_kpi_overdue KPI card: count and total value of overdue Sales Invoices (due_date < today, outstanding_amount > 0, submitted). erpnext_kpi_revenue KPI card: total Sales Order revenue for the current month, with delta % vs previous month and sparkline of last 6 months. erpnext_lead_get Get a single CRM Lead by name. Returns all lead details including contact info. erpnext_lead_list List CRM Leads. Filterable by status, lead_owner. Fields: name, lead_name, company_name, status, lead_owner, email_id, mobile_no. erpnext_leave_application_get Get a single Leave Application by name. Returns full document. erpnext_leave_application_list List Leave Applications. Filterable by employee, status, leave_type. Fields: name, employee, employee_name, leave_type, from_date, to_date, status. erpnext_leave_balance Get leave balance (allocations) for an employee. Returns Leave Allocations with leave_type, total_leaves_allocated, new_leaves_allocated. erpnext_opportunity_get Get a single CRM Opportunity by name. Returns full details including items and competitors. erpnext_opportunity_list List CRM Opportunities. Filterable by status, opportunity_owner, opportunity_from. Fields: name, opportunity_from, party_name, status, opportunity_... erpnext_order_breakdown Breakdown of Sales Orders by customer (stacked-bar by status) or as a pie chart of totals. type='stacked-bar' → orders stacked by status per custom... erpnext_payment_entry_get Get a single Payment Entry by name (e.g. PE-00001). Returns full document including references. erpnext_payment_entry_list List Payment Entries. Filterable by payment_type, party_type, date range. Fields: name, payment_type, party_type, party, posting_date, paid_amount,... erpnext_payroll_entry_list List Payroll Entries. Filterable by company, status. Fields: name, company, posting_date, payroll_frequency, status. erpnext_price_vs_qty Scatter chart: item selling price (X) vs total qty ordered (Y). Each point is an item. Colored by item group if available. erpnext_product_radar Radar chart comparing items across multiple dimensions: stock level, stock value, order frequency, and revenue. Pass 2-4 item codes to compare. erpnext_profit_loss Profit & Loss overview — bar chart comparing total income vs total expenses per month from Sales Orders (income) and Purchase Orders (expenses). Sh... erpnext_project_get Get a single Project by name. Returns full document including tasks summary. erpnext_project_list List Projects. Filterable by status. Fields: name, project_name, status, percent_complete, expected_start_date, expected_end_date, estimated_costing. erpnext_purchase_invoice_get Get a single Purchase Invoice by name (e.g. PINV-00001). Returns full document with line items. erpnext_purchase_invoice_list List Purchase Invoices (bills from suppliers). Filterable by supplier, status, date range. Fields: name, supplier, posting_date, due_date, status, ... erpnext_purchase_order_get Get a single Purchase Order by name (e.g. PO-00001). Returns full document with line items. erpnext_purchase_order_list List Purchase Orders. Filterable by supplier, status, date range. Fields: name, supplier, transaction_date, schedule_date, status, grand_total, cur... erpnext_purchase_receipt_get Get a single Purchase Receipt by name (e.g. MAT-PRE-00001). Returns full document with received items. erpnext_purchase_receipt_list List Purchase Receipts (goods received notes). Filterable by supplier, status, date range. Fields: name, supplier, posting_date, status, total_qty,... erpnext_quotation_get Get a single Quotation by name. Returns full document with line items and terms. erpnext_quotation_list List Quotations. Filterable by party_name, status. Fields: name, party_name, transaction_date, status, grand_total. erpnext_revenue_vs_orders Composed chart (bar + line) showing revenue (bars, left axis) vs order count (line, right axis) per customer. Demonstrates dual-axis composed chart. erpnext_salary_slip_get Get a single Salary Slip by name/ID. Returns all fields including earnings and deductions. erpnext_salary_slip_list List Salary Slips. Filterable by employee, status, date range. Fields: name, employee, employee_name, posting_date, start_date, end_date, gross_pay... erpnext_sales_chart Analyze sales revenue as a chart. group_by='customer' → bar chart of top customers by revenue. group_by='item' → bar chart of top items sold. group... erpnext_sales_funnel Sales funnel from Lead → Opportunity → Quotation → Sales Order. Shows count and value at each stage with conversion rates between stages. erpnext_sales_invoice_get Get a single Sales Invoice by name (e.g. SINV-00001). Returns full document with line items. erpnext_sales_invoice_list List Sales Invoices. Filterable by customer, status, date range. Fields: name, customer, posting_date, due_date, status, grand_total, outstanding_a... erpnext_sales_order_get Get a single Sales Order by name (e.g. SO-00001). Returns full document with line items. erpnext_sales_order_list List Sales Orders. Filterable by customer, status, date range. Fields: name, customer, transaction_date, status, grand_total, currency. erpnext_shipment_get Get a single Shipment by name. Returns full shipment details including parcels. erpnext_shipment_list List Shipments. Filterable by status, pickup_from date range. Fields: name, status, pickup_date, delivery_date, carrier, shipment_amount. erpnext_stock_balance Get stock balance by item and/or warehouse. Reads from the Bin DocType. Fields: item_code, warehouse, actual_qty, reserved_qty, projected_qty, valu... erpnext_stock_chart Get stock levels as a bar chart. Shows actual_qty per item (optionally filtered by warehouse). Groups items and returns chart-ready data. Use type=... erpnext_stock_entry_get Get a single Stock Entry by name. Returns full document with item details. erpnext_stock_entry_list List Stock Entries (material transfers, receipts, issues). Fields: name, stock_entry_type, posting_date, from_warehouse, to_warehouse, total_amount... erpnext_stock_treemap Stock value as a treemap. Each rectangle represents an item, sized by stock value. Use group_by='warehouse' to group by warehouse instead. erpnext_supplier_get Get a single ERPNext supplier by name (ID). Returns all fields including contact details. erpnext_supplier_list List ERPNext suppliers. Returns active suppliers by default. Fields: name, supplier_name, supplier_group, supplier_type, email_id, disabled. erpnext_supplier_quotation_list List Supplier Quotations (RFQ responses from suppliers). Filterable by supplier, status. Fields: name, supplier, transaction_date, status, grand_to... erpnext_task_get Get a single Task by name. Returns full document including description and dependencies. erpnext_task_list List Tasks. Filterable by project, status, priority. Fields: name, subject, project, status, priority, exp_start_date, exp_end_date, progress. erpnext_timesheet_get Get a single Timesheet by name. Returns full document with time log details. erpnext_timesheet_list List Timesheets. Filterable by employee, project. Fields: name, employee, start_date, end_date, status, total_hours. erpnext_warehouse_list List ERPNext Warehouses. Fields: name, warehouse_name, warehouse_type, company. erpnext_work_order_get Get a single Work Order by name (e.g. MFG-WO-00001). Returns full document with operations and materials. erpnext_work_order_list List Work Orders. Filterable by production_item, status, date range. Fields: name, production_item, qty, produced_qty, status, planned_start_date, ...

WRITE TOOLS

29
erpnext_asset_create Create a new Asset record. Requires asset_name, asset_category, company, purchase_date, gross_purchase_amount. Optionally set location, custodian, ... 2/5 erpnext_company_create Create an ERPNext Company. Requires company_name, abbr, default_currency, country. Prerequisites: Warehouse Type 'Transit' and 'Default' must exist... 2/5 erpnext_customer_create Create a new Customer. Requires customer_name. Optionally set customer_group, territory, email_id. 2/5 erpnext_customer_update Update an existing Customer. Pass only the fields you want to change. 2/5 erpnext_delivery_note_create Create a new Delivery Note. Requires customer and at least one item with item_code, qty. Typically created against a Sales Order. 2/5 erpnext_doc_create Create any ERPNext document. Works on any DocType including master data (Company, Item Group, UOM, Territory, Customer Group, Supplier Group, Wareh... 2/5 erpnext_doc_submit Submit any ERPNext document (changes status from Draft to Submitted). Applies to submittable DocTypes like Sales Order, Purchase Order, Sales Invoi... 2/5 erpnext_doc_update Update any ERPNext document (partial update). Works on any DocType. Pass doctype (e.g. 'Customer', 'Sales Order'), the document name, and the field... 2/5 erpnext_expense_claim_create Create a new Expense Claim. Requires employee and expenses array. Each expense item maps to the Expense Claim Detail child table. 2/5 erpnext_item_create Create a new Item (product or service). Requires item_code and item_name. Set is_stock_item=false for service/non-stocked items. 2/5 erpnext_item_update Update an existing Item. Pass only the fields you want to change. 2/5 erpnext_journal_entry_create Create a new Journal Entry. Requires voucher_type and accounts with debit/credit amounts. Total debits must equal total credits. 2/5 erpnext_kanban_move_card Move a kanban card for a supported ERPNext DocType. Returns structured success or business error details for MCP App reconciliation. 2/5 erpnext_lead_create Create a new CRM Lead. Requires lead_name. Optionally set company_name, email_id, mobile_no, source. 2/5 erpnext_leave_application_create Create a new Leave Application. Requires employee, leave_type, from_date, to_date. Dates in YYYY-MM-DD format. 2/5 erpnext_project_create Create a new Project. Requires project_name. Optionally set expected_start_date and expected_end_date. 2/5 erpnext_purchase_order_create Create a new Purchase Order. Requires supplier and at least one item with item_code, qty, rate. Optionally set schedule_date (YYYY-MM-DD). 2/5 erpnext_quotation_create Create a new Quotation for a customer or lead. Requires quotation_to (Customer or Lead), party_name, and at least one item. 2/5 erpnext_revenue_trend Sales revenue trend over time. Returns a line chart (or area if type='area') with monthly revenue from Sales Orders. Add group_by='customer' for mu... 2/5 erpnext_sales_invoice_create Create a new Sales Invoice. Requires customer and at least one item. On a fresh ERPNext instance, you may also need to set company, selling_price_l... 2/5 erpnext_sales_invoice_submit Submit a Draft Sales Invoice (posts it to the ledger, changes status to 'Unpaid'). Once submitted, the invoice is visible to the customer and affec... 2/5 erpnext_sales_order_create Create a new Sales Order. Requires customer and at least one item with item_code, qty, rate. On a fresh ERPNext instance, you may also need to set ... 2/5 erpnext_sales_order_submit Submit a Draft Sales Order (changes status to 'To Deliver and Bill'). Triggers stock reservation and fulfillment workflow. 2/5 erpnext_sales_order_update Update an existing Sales Order (only in Draft status). Pass only the fields you want to change (e.g. delivery_date, items). 2/5 erpnext_stock_entry_create Create a new Stock Entry (material issue, receipt, or transfer). Requires stock_entry_type and items with item_code and qty. For Material Issue: se... 2/5 erpnext_supplier_create Create a new ERPNext Supplier. Requires supplier_name and supplier_group. Returns the created supplier document. 2/5 erpnext_task_create Create a new Task in a project. Requires project and subject. Dates in YYYY-MM-DD format. 2/5 erpnext_task_update Update an existing Task. Pass only the fields you want to change. Commonly used to change status, progress, or dates. 2/5 erpnext_work_order_create Create a new Work Order for manufacturing. Requires production_item, bom_no, and qty. Optionally set planned_start_date and wip_warehouse. 2/5

DESTRUCTIVE TOOLS

3
How many tools does the Mcp Erpnext MCP server have? +

The Mcp Erpnext MCP server exposes 120 tools across 3 categories: Read, Write, Destructive.

How do I enforce policies on Mcp Erpnext tools? +

Use Intercept, the open-source MCP proxy. Write YAML rules for each tool — rate limits, argument validation, or deny rules — then run Intercept in front of the Mcp Erpnext server.

What risk categories do Mcp Erpnext tools fall into? +

Mcp Erpnext tools are categorised as Read (88), Write (29), Destructive (3). Each category has a recommended default policy.

Enforce policies on Mcp Erpnext

Open source. One binary. Zero dependencies.

npx -y @policylayer/intercept
github.com/policylayer/intercept →
// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.