Using `frappe-mcp` with Frappe version 15

[vaidik]

Thanks for building this project.

I am using Frappe 15.43. When I try to configure OAuth2 in Frappe, I just dont see anything in my installation of Frappe as documented here (https://docs.frappe.io/framework/oauth2). I believe the docs are for a newer version of Frappe.

When I try to hit "connect" in Inspector, I get the following error in the server console:

15:47:08 web.1      | Initializing
15:47:08 web.1      | Traceback (most recent call last):
15:47:08 web.1      |   File "apps/frappe/frappe/handler.py", line 74, in execute_cmd
15:47:08 web.1      |     method = get_attr(cmd)
15:47:08 web.1      |              ^^^^^^^^^^^^^
15:47:08 web.1      |   File "apps/frappe/frappe/handler.py", line 287, in get_attr
15:47:08 web.1      |     method = frappe.get_attr(cmd)
15:47:08 web.1      |              ^^^^^^^^^^^^^^^^^^^^
15:47:08 web.1      |   File "apps/frappe/frappe/__init__.py", line 1765, in get_attr
15:47:08 web.1      |     return getattr(get_module(modulename), methodname)
15:47:08 web.1      |                    ^^^^^^^^^^^^^^^^^^^^^^
15:47:08 web.1      |   File "apps/frappe/frappe/__init__.py", line 1483, in get_module
15:47:08 web.1      |     return importlib.import_module(modulename)
15:47:08 web.1      |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
15:47:08 web.1      |   File "/<path>/.pyenv/versions/3.11.9/lib/python3.11/importlib/__init__.py", line 126, in import_module
15:47:08 web.1      |     return _bootstrap._gcd_import(name[level:], package, level)
15:47:08 web.1      |            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
15:47:08 web.1      |   File "<frozen importlib._bootstrap>", line 1204, in _gcd_import
15:47:08 web.1      |   File "<frozen importlib._bootstrap>", line 1176, in _find_and_load
15:47:08 web.1      |   File "<frozen importlib._bootstrap>", line 1147, in _find_and_load_unlocked
15:47:08 web.1      |   File "<frozen importlib._bootstrap>", line 690, in _load_unlocked
15:47:08 web.1      |   File "<frozen importlib._bootstrap_external>", line 940, in exec_module
15:47:08 web.1      |   File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
15:47:08 web.1      |   File "apps/memberships/memberships/mcp.py", line 3, in <module>
15:47:08 web.1      |     from flask import Response
15:47:08 web.1      | ModuleNotFoundError: No module named 'flask'
15:47:08 web.1      | 
15:47:08 web.1      | During handling of the above exception, another exception occurred:
15:47:08 web.1      | 
15:47:08 web.1      | Traceback (most recent call last):
15:47:08 web.1      |   File "apps/frappe/frappe/app.py", line 114, in application
15:47:08 web.1      |     response = frappe.api.handle(request)
15:47:08 web.1      |                ^^^^^^^^^^^^^^^^^^^^^^^^^^
15:47:08 web.1      |   File "apps/frappe/frappe/api/__init__.py", line 49, in handle
15:47:08 web.1      |     data = endpoint(**arguments)
15:47:08 web.1      |            ^^^^^^^^^^^^^^^^^^^^^
15:47:08 web.1      |   File "apps/frappe/frappe/api/v1.py", line 36, in handle_rpc_call
15:47:08 web.1      |     return frappe.handler.handle()
15:47:08 web.1      |            ^^^^^^^^^^^^^^^^^^^^^^^
15:47:08 web.1      |   File "apps/frappe/frappe/handler.py", line 49, in handle
15:47:08 web.1      |     data = execute_cmd(cmd)
15:47:08 web.1      |            ^^^^^^^^^^^^^^^^
15:47:08 web.1      |   File "apps/frappe/frappe/handler.py", line 76, in execute_cmd
15:47:08 web.1      |     frappe.throw(_("Failed to get method for command {0} with {1}").format(cmd, e))
15:47:08 web.1      |   File "apps/frappe/frappe/__init__.py", line 652, in throw
15:47:08 web.1      |     msgprint(
15:47:08 web.1      |   File "apps/frappe/frappe/__init__.py", line 617, in msgprint
15:47:08 web.1      |     _raise_exception()
15:47:08 web.1      |   File "apps/frappe/frappe/__init__.py", line 568, in _raise_exception
15:47:08 web.1      |     raise exc
15:47:08 web.1      | frappe.exceptions.ValidationError: Failed to get method for command memberships.mcp.handle_mcp with No module named 'flask'
15:47:08 web.1      | 
15:47:08 web.1      | 127.0.0.1 - - [24/Aug/2025 15:47:08] "POST /api/method/memberships.mcp.handle_mcp HTTP/1.1" 417 -

When I try the OAuth flow in Inspector, I get the following error:

15:51:24 web.1      | 127.0.0.1 - - [24/Aug/2025 15:51:24] "OPTIONS /.well-known/oauth-protected-resource HTTP/1.1" 200 -
15:51:24 watch.1    | Watching for changes...
15:51:24 web.1      | 127.0.0.1 - - [24/Aug/2025 15:51:24] "GET /.well-known/oauth-protected-resource HTTP/1.1" 404 -

I belive frappe_mcp works with later versions of Frappe or am I missing something in my OAuth2 setup?

Thanks for your help

[18alantom]

frappe/mcp needs this frappe/frappe#33188 PR in frappe to work without manual config. It's not available in version 15, only on the latest.

The first error appears to be originating from an app on your bench memberships due to importing Response from flask. You can try importing it from Werkzeug instead.

Regarding the second error, the OAuth flow won't work without the PR, you'll have to manually set up an OAuth Client and then initiate the OAuth flow for the user to authorize.

[vaidik]

Ah damn. Apologies about the first error. I did miss that.

On setting up the OAuth Client, are there any instructions to set up the OAuth client with Inspector as the client? I am particularly struggling with these two problems:

• What should be the redirect URI for Inspector?
• Even with the client setup, I am not quite sure if the second error of not being able to serve /.well-known/oauth-protected-resource will still remain? I couldnt find any references of that in my version of Frappe. However, I could find that clearly in the latest version of Frappe. Will I have to do anything else after setting up the client to enable discovery of OAuth metadata? I keep getting this error in inspector:

[vaidik]

If you have instructions for older versions of Frappe, that will be very very helpful. Thanks!

[18alantom]

Oh yeah the /.well-known paths were added in the aforementioned PR. Check this doc for how to setup the client.

These should be the URLs you give Inspector:

• Auth URL <frappe_site_url>/api/method/frappe.integrations.oauth2.authorize
• Token URL <frappe_site_url>/api/method/frappe.integrations.oauth2.get_token

I'll add docs for older versions, might take a while though. Any reason for not using latest?

[vaidik]

Oh yeah the /.well-known paths were added in the aforementioned PR. Check this doc for how to setup the client.

But these docs are for newer versions of Frappe, right? If I am on an older version, do I need to implement these myself or is there a work around?

I'll add docs for older versions, might take a while though. Any reason for not using latest?

We are already using an older version in prod. Need to upgrade but haven't had the time to plan a full upgrade. Requires us to spend some time in testing.

These should be the URLs you give Inspector:

• Auth URL <frappe_site_url>/api/method/frappe.integrations.oauth2.authorize
• Token URL <frappe_site_url>/api/method/frappe.integrations.oauth2.get_token

Do you know how to pass these to inspector? Nothing in their UI or docs

[18alantom]

The page I sent you last should work for v15. It tells you how to register an OAuth client on your Frappe instance. Once you register the client you can manually enter the creds here:

(MCP Inspector > Left panel > Authentication)