Frappe Dev MCP Server

Add website_generators hook for DocTypes that generate web pages

Amend a cancelled document (create amended copy)

Apply a workflow action/transition on a document

Build front-end assets for all apps or a specific app

Run the frontend build process (yarn build) and copy assets to the Frappe app's public directory

Bulk update documents of a DocType

Execute a whitelisted Frappe/ERPNext method via bench. Note: In v16, state-changing methods require POST.

Cancel a submitted document

Check if a user has permission on a document

Clear cache for a Frappe site

Create a custom whitelisted API endpoint for a Frappe app

Create a new Frappe app with the bench scaffolding

Create a Client Script (custom JavaScript form script) for a DocType

Add a controller method (Python) to an existing DocType's controller file. Common methods: validate, before_save, after_insert, on_submit, on_cancel, on_update_after_submit, before_naming, autoname.

Create a Dashboard Chart for data visualization

Create a Desktop Icon document (v16) - icons shown on the desktop/home screen. Supports Link, Folder, and App icon types with role-based visibility.

Create a new Frappe DocType with JSON definition and Python controller. Supports all v16 field types including Tab Break, Dynamic Link, Table MultiSelect, Geolocation, JSON, etc.

Create a DocType dashboard configuration showing connections, charts, and related documents

Create a new Frappe document

Configure document naming rules (Naming Series, autoname patterns, etc.)

Create an Email Template with Jinja support for use in notifications and emails

Create or update a DocType's form JavaScript file (.js) for client-side customization

Create a Vue component file on disk using frappe-ui patterns with proper imports

Generate a detail/show page for viewing a single document with createDocumentResource, field display, actions (submit/cancel/amend/delete), timeline, and comments

Generate a form page/component with frappe-ui FormControl components, validation, and createDocumentResource integration for creating/editing documents

Generate a list view page with frappe-ui ListView, createListResource, filters, pagination, search, and row click navigation

Create a Vue page component with frappe-ui patterns and register its route in the router

Create a Letter Head template for document printing

Create a DocType's list view JavaScript file for list view customization

Create a Module Definition for a Frappe app

Create a Frappe Notification (email, system, SMS, or push notification triggered by document events)

Create a Number Card for dashboard KPIs

Create a custom Desk Page (single-page application within the desk). In v16, pages JS is evaluated as IIFE.

Create a database migration patch file for an app. Patches run during bench migrate.

Create a Pinia store with frappe-ui resource integration for complex state management

Create a Portal Page (www/ directory) with HTML/Jinja template and Python controller for a Frappe app

Create a custom Print Format (HTML/Jinja) for a DocType. v16 supports custom print formats for reports.

Generate a composable wrapping frappe-ui's resource system (createDocumentResource, createListResource, or createResource/call)

Create a new Role in the Frappe system

Create a Role Profile that groups multiple roles together

Create a Python method and register it as a scheduled task in hooks.py

Create a Script Report with Python data generation and optional JS client-side script

Create a Server Script (DocType Event, API, Permission Query, or Scheduled) directly in Frappe's database

Create a test file (unit + integration) for a DocType using Frappe v16 test patterns

Create UI blocks using frappe-ui and Tailwind CSS patterns

Create a Virtual DocType (no database table, data from external source or computed). Common in v16 for API-backed data.

Create a Web Form for public-facing data entry

Create a Web Page document for the website

Create a Jinja template file for emails, print, or web pages

Create a Webhook to send data to external services on document events

Create a complete Workflow with states, transitions, and actions for a DocType

Create a Workspace page (v16 redesigned workspace with sidebar navigation and desktop icon support)

Create a Workspace Sidebar (v16) - the persistent left sidebar navigation. Public sidebars (no for_user) appear for all users. Private sidebars (with for_user) appear only for that user in 'My Workspaces'.

Delete a Custom Field from a DocType

Delete a Desktop Icon by name/label

Delete a Frappe document

Enqueue a background job using frappe.enqueue() (RQ)

Export data from a DocType to JSON

Export fixture data for an app (exports DocTypes defined in hooks.py fixtures)

Generate a Vue 3 component using frappe-ui library

Generate a complete Vue page with frappe-ui layout and components

Clone/get a Frappe app from a git URL

Get the directory structure of a Frappe app

Get count of documents matching filters

Get the full customization of a DocType (custom fields, property setters, etc.)

Get a CSV import template for a DocType

List all available DocTypes, optionally filtered by module or app

Get the complete schema/structure of a DocType including fields, permissions, and properties

Retrieve a Frappe document by DocType and name

Get available options for Link or Select fields in a DocType

Get financial statements (Profit & Loss, Balance Sheet, Cash Flow) from ERPNext

Get comprehensive Frappe development information: version, installed apps, DocType stats, API endpoints, and development tips

Get the directory structure of a frappe-ui frontend app

Read and display the current hooks.py file of a Frappe app

Get the status of background jobs

Get all permission rules for a DocType

Get rendered print output for a document

Get metadata for a Frappe report (columns, filters, etc.)

Get available UI templates and patterns organized by category

Get specific field value(s) from a document

Get the Vue component tree structure for a page

Get workflow definition for a DocType

Get available workflow actions for a document based on current state and user role

Get the Workspace Sidebar configuration for the current user or a specific sidebar by title

Import data from CSV/JSON into a DocType using Frappe Data Import

Import fixture data from an app's fixtures directory

Generate creative UI blocks inspired by modern design patterns

Install a Frappe app on a site

List all installed apps on a site

List all Client Scripts

List all Custom Fields for a DocType

List Desktop Icon documents (v16), optionally filtered by app, icon_type, or role

List Frappe documents with filters, field selection, ordering, and pagination

List all Notification documents

List all Print Formats, optionally filtered by DocType

List all available reports, optionally filtered by type or DocType

List all Server Scripts

List all web pages

List all Workspace Sidebars (v16), optionally filtered by user or standard status

List all workspaces (v16: public ones appear as desktop icons, private ones in 'My Workspaces' sidebar)

Run database migration for a Frappe site

Create a new Frappe site

Purge failed/pending background jobs

Refine and improve existing UI blocks with responsive, dark mode, or animation enhancements

Rename a document

Restart bench services (web, worker, scheduler)

Execute any bench command for Frappe development

Generate a quick report based on a DocType listing with filters

Run a specific patch manually

Execute a Frappe query report with filters

Run tests for a Frappe app, module, or specific DocType

Scaffold a complete frappe-ui SPA inside a Frappe app's frontend/ directory with Vue 3, Vite, Tailwind CSS, frappe-ui, vue-router, and optionally Pinia

Check scheduler status or enable/disable scheduler

Send an email programmatically via Frappe. Note: v16 frappe.sendmail(now=True) no longer commits transactions.

Set any arbitrary property in hooks.py (for hooks not covered by specialized tools)

Set a specific field value on a document

Configure field-level permissions (permlevel) for DocType fields. v16 supports role-based field masking.

Create/update the proxyOptions.js file for connecting the Vite dev server to a Frappe backend site

Install Python and Node dependencies for all apps

Submit a submittable document

Uninstall a Frappe app from a site

Update an existing Frappe document

Update website settings (homepage, navbar, footer, brand, favicon, etc.)

Update an existing Workspace Sidebar - add, remove, or reorder items

A decorator that registers a function as a tool that can be used by an LLM. Example: >>> @mcp.tool() ... def get_current_weather(location: str, unit: str = "celsius"): ... '''Get the current weather in a given location.''' ... # ... implementation ... Args: name: The name of the tool. If not provided, the function's `__name__` will be used. description: A description of what the tool does. If not provided, it will be extracted from the function's docstring. input_schema: The JSON schema for the tool's input. If not provided, it will be infe…