On Page Navigation

Managed Frappe MCP Setup for ERPNext Builder CRM

The Frappe MCP connector lets an AI agent read and write any DocType on your site, and manage your Builder pages besides. We wrote it, it is free, and it is open source, so installing it costs you nothing at all. What nobody hands you is a decision about which DocTypes that agent may reach, which user it connects as, and what happens the first time it misreads an instruction. That is the part we run.

Cascadia engineer working across dual monitors.

Narrow by design, not by accident

What makes our managed Frappe MCP different

Installing the connector takes an afternoon, and we built it to be that easy on purpose. Far fewer people will sit down first and work out what an agent should never be allowed to do. The second job is the one that matters once the agent can post to your general ledger.

So the setup below is mostly about boundaries. Which doctypes an agent may read, which it may write, and which it must never touch at all. A dedicated user with its own role profile, so the agent's permissions are visible in one place instead of quietly inherited from whoever set it up. Credentials that can be revoked without breaking anything else. Every call logged and attributable to a request. And a written scope you approve before the connector is ever pointed at production, because the alternative is discovering the limits by accident.

Why a shorter list beats a quicker one

Managed Frappe MCP against wiring it up yourself

Most teams connect an agent the quickest way that works, which usually means an API key generated against whichever account already had System Manager. Nothing goes wrong on day one. Every row below is about who carries the consequence later.

The agent connects as a user built for the job

Wiring it up in a hurry means generating an API key against whoever already held System Manager. The agent inherits that reach permanently, and nobody goes back to narrow it.

Write access earned one tool at a time, after testing

The fast path enables every tool at once, submit and cancel included. That is fine until an agent reads a vague instruction generously and posts something somebody then has to reverse by hand.

Somebody has read the role profile, not just set it

Role permissions and user permissions are both real protections, and both only work if a person reads them. Configured in a hurry, they become a permission set nobody can describe six months later.

A dropped connection repaired at no extra charge

Keys expire, permissions change and clients stop authenticating. Coverage includes unlimited repairs on the connections we manage, with no charge per incident and no queue to join.

Version upgrades absorbed before they break things

An MCP server sits directly on top of your DocTypes, so a renamed custom field or a major version upgrade can quietly alter what a tool returns. We test that on staging rather than hear about it from you.

One monthly picture of what the agents actually did

Frappe writes a Version record for every change and almost nobody opens them. Without somebody reading them, a tool being used in a way nobody intended stays invisible until it matters.

Where this pays for itself

Who needs managed Frappe MCP most

This earns its place fastest where an agent is already reaching live ledger data, or where somebody is about to connect one and nobody has yet decided what it should be allowed to do.

How the build runs

How our managed Frappe MCP setup works

The first conversation is about what an agent must never be allowed to do. That is harder than standing the server up, and it is the part that decides whether any of this goes well.

1

We agree the list before anything gets connected

Which DocTypes the agents genuinely need, which tools against them, and which user the server runs as. We argue for a shorter list than most people start with, and write down what was left out and why.

2

We build it read only and test on a staging bench

The server goes up able to look and not touch, connected under a dedicated service user with both permission layers reviewed. Prompts run against a staging bench so the failure modes show up well before live data is involved.

3

We add write access slowly, then keep it honest

Write tools go on one at a time, each tested before the next, with submit and cancel last of all or not at all. After that it is monitoring, Version review, repairs when a connection drops, and a monthly note on what the agents actually did.

What managed Frappe MCP costs

Pricing

Managed Frappe MCP

Monthly Subscription

$300.00
/per month
One site or bench covered

DETAILS

The server built and scoped for one site, connected under a dedicated service user with the role profile and user permissions both reviewed. Client setup for the tools your team uses, tool level allow lists, Version review, unlimited repairs on the connections we manage, and a monthly report in plain language.

Managed Frappe MCP - Plus

Monthly Subscription

$700.00
/per month
Multiple sites or benches covered

DETAILS

Everything in the standard plan across more than one site or bench, plus connections out to third party services where they earn their place, priority response, upgrade testing ahead of major ERPNext versions, and a quarterly review of what every agent is still allowed to reach.

Testimonials

Here's what others had to say

Everything included

Everything included in managed Frappe MCP

Cascadia Web Services logo

The Server Scoped To The DocTypes That Matter

The connector can read and write any DocType on your site. That includes GL Entry, Payment Entry, Sales Invoice and Salary Slip, not only the friendly ones. We allow list the DocTypes the work genuinely needs and leave the rest unreachable, because every DocType exposed is another thing an agent can act on.
Cascadia Web Services logo

A Dedicated Service User, Never System Manager

Frappe permissions are role based, so an agent connected as System Manager inherits every role that user holds. We create a service user with a role profile built for the job, so the ceiling on what an agent can do is set on purpose rather than inherited from whoever happened to be logged in.
Cascadia Web Services logo

Role Permissions And User Permissions Both Reviewed

Role permissions set the DocType level ceiling. User permissions narrow it to particular companies, warehouses or territories. Most setups configure one and forget the other, which is how an agent scoped to one company ends up reading the whole group.
Cascadia Web Services logo

Tool Level Allow Lists Across Every Tool

The connector exposes 24 tools rather than one blanket connection. Reading a Sales Invoice and submitting one are different tools, and an agent that only needs the first should not hold the second. The allow list is written down and reviewed rather than left at whatever the default was.
Cascadia Web Services logo

Read Only First, Write Added Deliberately

Every server starts able to look and not touch. Write tools go on one at a time, each tested before the next is added. It is slower for a fortnight and it is the difference between an agent that answers questions and an agent that quietly creates records nobody asked for.
Cascadia Web Services logo

Submit And Cancel Held Back Longest

In Frappe a submit is not an edit. It posts to the ledger, and a cancel reverses it with an amendment trail behind it. Those are the two most consequential tools in the set, so they go on last, only where the work truly needs them, and sometimes not at all.
Cascadia Web Services logo

Tested On A Staging Bench Before Production

Frappe Cloud makes a staging site inexpensive, so prompts get run against a copy of your data before anything points at the live bench. What a model does with an ambiguous instruction is worth learning somewhere the ledger does not matter.
Cascadia Web Services logo

Prompt To Action Verification

We check what a plausible instruction actually does, not what it should do. Natural language is imprecise, and a model asked to update the Acme order will sometimes find the wrong Acme. The cases where that happens get found and constrained during setup rather than in production.
Cascadia Web Services logo

Builder Page Tools Scoped Separately

The connector also manages Frappe Builder pages, which means an agent can edit your website as well as your ledger. Those are different risks with different audiences, so they get scoped as two separate decisions rather than one.
Cascadia Web Services logo

Client Connections Configured And Documented

Claude, ChatGPT, Cursor or whatever your team uses. The protocol is model agnostic, so any client speaking it can connect, and each one gets set up, tested and written down so a new starter does not have to work it out from scratch.
Cascadia Web Services logo

Schema And Custom Field Changes Watched

An MCP server sits directly on top of your DocTypes, so a renamed custom field or a customised form can quietly change what a tool returns. We watch for that rather than hear about it from you, which is the same discipline we already run on automations.
Cascadia Web Services logo

Version Upgrades Tested Against Your Tools

ERPNext ships major versions and the surface underneath the connector moves with them. Upgrades get tested against your actual tool set on staging first, so the morning after an upgrade is not the morning your agents stop working.
Cascadia Web Services logo

Credentials Rotated On A Schedule

API keys and connection credentials get rotated rather than left in place indefinitely, and the rotation is logged. A credential that has been valid since setup is a credential nobody has thought about since setup.
Cascadia Web Services logo

A Written Map Of What The Agent Can Reach

One document listing every DocType exposed, every tool enabled, the service user behind it and what that user can do. When somebody asks whether the agent can see payroll, the answer is a lookup rather than an investigation.
Cascadia Web Services logo

Monthly Report In Plain Language

What the agents did, what changed, what we adjusted and anything we think should be switched off. Written to be read in a few minutes by somebody who does not want to think about protocols.
Cascadia Web Services logo

Break And Fix, Plus Clean Revocation

When a connection drops, a key expires or a client stops authenticating, it is ours to repair, with no per incident charge and no queue to join. Ending the arrangement means disabling the service user and handing over the configuration document. Nothing is held hostage because nothing was ever registered to us.

Managed Frappe MCP questions we get asked most

Frequently asked questions
What is the Frappe MCP connector?
Our implementation of the Model Context Protocol for ERPNext and Frappe. It stands up a server that exposes tools, actions and data from your site in a form an AI agent can use, so an instruction in plain language becomes a real action against a DocType. We wrote it, it is free, and it is open source. What it does not supply is a decision about what your agents should be allowed to do.
Is the connector free?
Yes, entirely. It is our own open source project and there is no licence, no seat count and no paid tier. If you want to install it and wire it up yourself, go and do that, and nothing on this page argues otherwise. What you would be buying here is the scoping and the ownership afterwards, not the software.
Then what exactly am I paying you for?
Judgement about scope, and somebody answerable for it. Standing the server up is genuinely easy, and we made it easy on purpose. Deciding which DocTypes an agent should reach, which tools it gets, which user it connects as, and what happens when it misreads an instruction is the part that is not easy, and it is the part that carries consequences. That work continues every month because your site does.
Should we buy this at all?
Often not, and now is a better time to find that out than month six. If one person there is comfortable reading a role profile, will test on staging before pointing anything at the live bench, and has the hours, install it and keep the money. This starts making sense when agents are reaching real ledger data, when more than one person is connecting clients, and when nobody can currently say what the agents are allowed to touch.
Which parts of ERPNext does this cover?
Technically all of it, which is exactly the problem. The connector can read and write any DocType, and it adds Builder page management and CRM and Selling workflows on top. We cover the parts you actually use, and part of the service is arguing you down to a shorter list than you first ask for.
Can the agent change our data, or only read it?
Both, and that is the whole point of the protocol and the whole risk in it. An agent with the right tools can create a customer, raise an invoice or post a payment. Every server we run starts read only and write access is added one tool at a time after testing. Which write tools are live is a decision recorded in your configuration document rather than a default nobody reviewed.
Can an agent submit or cancel a document?
Only if you decide it should, and we will push back hard on that one. A submit in Frappe posts to the ledger and a cancel reverses it, so those two tools carry more consequence than everything else in the set combined. They go on last, after everything else has run cleanly for a while, and plenty of setups never enable them at all.
What stops an agent doing something expensive?
The permissions of the user it connects as, and nothing else. Frappe enforces role permissions and user permissions on every request, which is a real protection, and it is also why connecting the server as System Manager removes it entirely. This is the single most important thing to get right and it is why we never connect as an administrator.
Which AI clients does this work with?
Anything that speaks the protocol, including Claude, ChatGPT, Cursor and agent frameworks. We set up and document the clients your team actually uses. If you switch models later that is a configuration change rather than a rebuild, which is one of the better things about the protocol.
Do you need System Manager access to our site?
Briefly, to create the service user, build the role profile and authorise the connection, and then no. The ongoing arrangement runs on the service account rather than on an administrator login. Your site stays yours and we do not become a permanent System Manager on it.
What happens when we upgrade ERPNext?
We test it first. A major version can change a DocType, rename a field or alter what a report returns, and an MCP server sitting on top of that inherits every one of those changes. Upgrades get run on staging against your actual tool set before they reach production, and fixing what moves is included.
Do you host anything?
No. The server runs against your own site, on your own bench, whether that is Frappe Cloud or your own infrastructure. The connections are yours and the configuration belongs to you. We manage it rather than own it, so leaving costs you a revocation and a handover document rather than a migration.
What is the difference between the two plans?
Standard covers one site with the server build, scoping, client setup, audit review, break and fix and monthly reporting. Plus covers multiple sites or benches, adds third party service connections, priority response, upgrade testing ahead of major versions and a quarterly scope review. Most businesses running one site belong on Standard and we will say so rather than selling up.
How long does the setup take?
The build itself is usually a few days. The scoping conversation ahead of it is the part that takes real time, because deciding what an agent may not do requires somebody who knows your business rather than the protocol. Expect a fortnight before anything writes to the live bench, and treat anybody promising same day production access with suspicion.
What if we want to leave?
Thirty days notice and nothing is stranded. We disable the service user, revoke the keys and hand over the document describing every DocType, tool and permission in the configuration. The site, the data and the connector itself were always yours, and the connector stays free and open source whether you keep paying us or not. There is nothing to migrate because nothing was ever ours to hold.
​Contact

Ask Us Anything

We’d love to hear from you!