MCP Modal Server
Shells out to your local Modal CLI to manage serverless infrastructure without juggling extra tokens. You get 26 tools spanning deployments (modal deploy/run), app lifecycle (logs, rollbacks, stop), container inspection and exec, plus volume and secret CRUD. Requires uv and an authenticated Modal profile. The deploy and run tools expect your project to use uv with modal installed. Watch out for the security surface: put_modal_volume_file can exfiltrate arbitrary local files, get_modal_volume_file can overwrite shell profiles, and exec_modal_container runs commands inside live containers. Set MCP_MODAL_ALLOWED_LOCAL_PATHS to restrict filesystem access if you're nervous about prompt injection. Useful when you want Claude to ship code to Modal or debug a running app without leaving the editor.
- GitHub stars
- 4
- tools
- 12
- transport
- STDIO
- last updated
- Sep 9, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
list_modal_resourcesone lookup for the whole account.
one lookup for the whole account.
No parameter schema in public metadata yet.
get_modal_logsfetch or stream logs for an app or a container.
fetch or stream logs for an app or a container.
No parameter schema in public metadata yet.
search_modal_logsgrep logs and get each hit with the surrounding lines, built for "where did it go wrong?" debugging.
grep logs and get each hit with the surrounding lines, built for "where did it go wrong?" debugging.
No parameter schema in public metadata yet.
deploy_modal_appDeploys a Modal app (`modal deploy`). Deployed web endpoints persist, so any links in the output are live and shareable (returned in `urls`).
Deploys a Modal app (`modal deploy`). Deployed web endpoints persist, so any links in the output are live and shareable (returned in `urls`).
No parameter schema in public metadata yet.
run_modal_appRuns a function or local entrypoint once and collects its output (`modal run`).
Runs a function or local entrypoint once and collects its output (`modal run`).
No parameter schema in public metadata yet.
manage_modal_app`action` is `stop` (shut the app down and terminate its containers) or `rollback` (redeploy a previous version).
`action` is `stop` (shut the app down and terminate its containers) or `rollback` (redeploy a previous version).
No parameter schema in public metadata yet.
manage_modal_container`action` is `exec` (run a command inside a running container, `modal container exec --no-pty`) or `stop` (terminate it).
`action` is `exec` (run a command inside a running container, `modal container exec --no-pty`) or `stop` (terminate it).
No parameter schema in public metadata yet.
manage_modal_volume`action` is `create`, `delete` (the volume **and all its data**, irreversible), or `rename`.
`action` is `create`, `delete` (the volume **and all its data**, irreversible), or `rename`.
No parameter schema in public metadata yet.
modal_volume_fileswrite operations on a volume's files: `action` is `put` (upload), `get` (download), `cp` (copy inside the volume), or `rm`.
write operations on a volume's files: `action` is `put` (upload), `get` (download), `cp` (copy inside the volume), or `rm`.
No parameter schema in public metadata yet.
manage_modal_secret`action` is `create` or `delete`.
`action` is `create` or `delete`.
No parameter schema in public metadata yet.
analyze_modal_costsread-only. Fetches `modal billing` once and aggregates locally, so you get ranked totals and period-over-period changes instead of hundreds of raw rows.
read-only. Fetches `modal billing` once and aggregates locally, so you get ranked totals and period-over-period changes instead of hundreds of raw rows.
No parameter schema in public metadata yet.
inspect_modal_secretlists the **key names** inside a secret, never the values.
lists the **key names** inside a secret, never the values.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Modal MCP Server
Manage Modal from Claude Code or any MCP client: apps, containers, logs, volumes, secrets and costs, plus deploying and running your own Modal apps.
It runs your local modal CLI, so it uses the profile and credentials already on your
machine. There are no extra tokens to manage.
Quick start
- Log in to Modal once (this writes
~/.modal.toml):
Details
- Repository
- github.com/george-bobby/mcp-modal
- Package
mcp-modal- Transport
- STDIO
- Registry
- MCP registry, active