Claude Code

Manage Saturn Cloud resources from Claude Code with the Saturn Cloud plugin

The Saturn Cloud plugin for Claude Code lets Claude create, inspect, and manage your Saturn Cloud workspaces, jobs, and deployments directly from a Claude Code session. It bundles two pieces:

An MCP server that exposes Saturn Cloud’s API as tools Claude can call (list resources, apply recipes, start/stop, schedule jobs, fetch logs, list instance types).
A skill that teaches Claude the Saturn Cloud recipe schema and conventions so it can author and edit recipes correctly without trial and error.

The plugin is open source and hosted on GitHub at saturncloud/claude-plugin.

Prerequisites

Claude Code installed and working.
A Saturn Cloud account and an API token (Settings → API Tokens).
uv installed — the MCP server runs in a Python virtual environment managed by uv.

Install

In a Claude Code session, add the Saturn Cloud marketplace directly from GitHub and install the plugin:
```
/plugin marketplace add saturncloud/claude-plugin
/plugin install saturn-cloud@saturn-local
```
Claude Code clones the plugin into its plugin directory (typically ~/.claude/plugins/marketplaces/saturncloud/claude-plugin).
The MCP server runs from a Python virtual environment that lives inside the installed plugin directory, so you need to create it once after installing. From your shell:
```
cd ~/.claude/plugins/marketplaces/saturncloud/claude-plugin
uv sync
```
If your Claude Code install uses a different plugin path, /plugin will print the location when you install — use that directory instead.
Restart Claude Code so it picks up the freshly created environment.

Configure

The MCP server reads two environment variables:

Variable	Description
`SATURN_BASE_URL`	Your Saturn Cloud installation URL (for example `https://app.community.saturnenterprise.io`, or your Saturn Enterprise URL)
`SATURN_TOKEN`	API token from Settings → API Tokens in the Saturn Cloud UI

Set both in your shell before launching Claude Code:

export SATURN_BASE_URL="https://app.community.saturnenterprise.io"
export SATURN_TOKEN="your-api-token"
claude

What Claude can do

Once the plugin is installed, Claude has access to the following Saturn Cloud tools:

Tool	What it does
`saturn_list_resources`	List your workspaces, jobs, and deployments
`saturn_get_resource`	Fetch a resource’s full recipe
`saturn_apply_recipe`	Create or update a resource from a recipe
`saturn_delete_resource`	Delete a resource
`saturn_start_resource` / `saturn_stop_resource`	Control runtime state
`saturn_schedule_job`	Set a cron schedule on a job
`saturn_get_logs`	Fetch logs for a resource
`saturn_list_instance_types`	List available compute sizes

Combined with the bundled skill, this means you can ask Claude things like:

“Create a Jupyter workspace with a GPU and the latest PyTorch image."
“Schedule my nightly-etl job to run every day at 2am UTC."
“Stop every workspace I’m not using right now."
“Show me the last 100 log lines from my failing deployment."
“Bump the instance type on my training job to an xlarge GPU."

Claude reads the recipe schema from the skill, so it will author valid recipes and explain trade-offs (instance sizes, disk space, image choices) without you needing to remember the field names.

Updating the plugin

Update the plugin from within Claude Code:

/plugin update saturn-cloud@saturn-local

If the update changes Python dependencies, re-sync the environment:

cd ~/.claude/plugins/marketplaces/saturncloud/claude-plugin
uv sync

Restart Claude Code afterwards so it loads the refreshed environment.

Troubleshooting

/plugin install fails with “marketplace not found” — make sure you ran /plugin marketplace add saturncloud/claude-plugin first.
The MCP server fails to start — confirm uv sync ran successfully inside the installed plugin directory and that .venv/bin/python exists there. Restart Claude Code after running uv sync.
Tools return authentication errors — re-check SATURN_BASE_URL and SATURN_TOKEN are exported in the shell that launched Claude Code. The token must belong to the same Saturn installation as SATURN_BASE_URL.

Feedback and contributions

Bug reports, feature requests, and pull requests are welcome on the GitHub repository. For general Saturn Cloud questions, email support@saturncloud.io.