SimpleBackups MCP server

Manage your backups directly from Claude, Cursor, Codex, and other MCP-compatible AI clients.

Connect SimpleBackups to Claude, Cursor, or any MCP client. The agent reads context, proposes fixes, and runs them in one conversation. Built on the Model Context Protocol, an open standard for connecting AI assistants to external tools.

iCurrently in private beta

The SimpleBackups MCP server is rolling out to a small group of customers first. Sign up for the private beta and we will email you when your account is enabled.

What is MCP?

MCP, short for Model Context Protocol, is an open standard that lets AI assistants connect to external tools and data sources securely. Instead of pasting API responses back and forth, your assistant talks directly to SimpleBackups over a single authenticated connection and gets exactly the data it needs to answer your question or run an action on your behalf.

The protocol is supported by Claude (Claude Code, Claude Desktop, Claude on the web), Cursor, OpenAI Codex, and a growing list of other AI clients. Any MCP-compatible client can connect to SimpleBackups using the same server URL.

Why connect SimpleBackups to your agent?

Most of the time you don't want to manage backups. You want an answer. Did anything fail last night? Why did the staging database backup error? Can you trigger the production backup before I deploy? Give me a restore link for last Friday's snapshot. With MCP, your agent answers those questions and performs those actions inline, without context-switching.

For teams, the value compounds. Engineers can investigate a failing backup from their editor, on-call can triage incidents without opening the dashboard, and ops can pause every backup before a maintenance window with one sentence, all using the same SimpleBackups team and the same permissions they already have.

What you can do

The MCP server exposes thirteen tools grouped into three areas:

• Account triage: answer "how is my account doing?" in one call: overall counts, failing backups, stale backups, and a sample of what needs attention.
• Backup investigation: drill into a single backup, read its recent run history, or pull a per-day status grid across many backups to spot patterns.
• Safe actions: trigger on-demand runs, pause or resume scheduled backups, and prepare a restore with type-specific instructions.

Every action runs as the user who connected the account, on the team you chose at connection time, and respects your existing role on that team.

Connecting your assistant

The SimpleBackups MCP server URL is:

https://mcp.simplebackups.ai/mcp

For deeper technical details, including the OAuth flow, dynamic client registration, tool schemas, and rate limits, see the MCP developer reference.

You connect using your SimpleBackups account through a standard OAuth flow. There are no API tokens to copy, no credentials to share with the AI client, and no separate password to manage. The first time your assistant connects, you are sent to SimpleBackups, you sign in if you aren't already, you pick which team the connection should act on, and you approve the connection. From that point on, the assistant has a scoped token tied to that team.

You can revoke a connection at any time from Settings → MCP connections.

Claude Desktop

In Claude Desktop, open Settings → Connectors → Add custom connector, give it a name like SimpleBackups, and paste the server URL above. Claude will open a browser tab to complete the OAuth flow, then return you to the chat with the connection ready.

Claude Code

In a terminal, add the connector to your Claude Code configuration:

claude mcp add --transport http simplebackups https://mcp.simplebackups.ai/mcp

The next time you start Claude Code, it will prompt you to complete the OAuth flow in your browser. After approval, the SimpleBackups tools appear automatically in the session.

Cursor

In Cursor, open Settings → MCP → Add new MCP server, choose the HTTP transport, and paste the server URL. Cursor opens the OAuth flow in your default browser.

Codex

In Codex CLI, add the SimpleBackups MCP server:

codex mcp add simplebackups --url https://mcp.simplebackups.ai/mcp

Codex opens the OAuth flow in your browser and stores the connection after you approve it.

Other MCP clients

Any MCP-compatible client that supports the streamable-http transport and OAuth 2.1 with Dynamic Client Registration can connect using the same server URL. Refer to your client's documentation for where to paste it. If your client does not support OAuth, contact us and we will help you find a path.

Available tools

Each tool is scoped to the team you picked at connection time and runs with your existing role on that team.

Tool	What it does
whoami	Returns the connected user, team, support id, and dashboard URLs. Called once at session start.
get-backups-overview	Single-call account health: aggregate counts plus a sample of failing or stale backups.
list-backups	Paginated listing with filters on type, status, server, storage, or name. Includes inline last status and error excerpt.
find-failing-backups	Returns only backups whose most recent run failed within a configurable window.
get-backup	Full details for one backup, including the latest run status and error message.
get-backup-logs	Recent run history for a single backup.
get-backup-runs-timeline	Per-day status grid across many backups in a single call, useful for spotting flaky days or patterns.
list-storages	Storage destinations (S3, B2, SFTP, Dropbox, …) with type, usage in GB, and connection status. Credentials are never returned.
list-servers	Servers and sources with connection type, host, and latest agent status. Credentials are never returned.
run-backups	Triggers on-demand runs for up to 20 backups per call. Supports dry_run to preview the resolved set.
pause-backups	Pauses one or many backups so they stop running on schedule. Supports dry_run.
resume-backups	Resumes paused backups so they run on schedule again. Supports dry_run.
restore-prep	Prepares a restore and provides type-specific restore instructions.

Example prompts

Once connected, you can speak to your agent the way you'd speak to a teammate. A few prompts to get started:

• "Any backups failed in the last 7 days?"
• "Draw me a status grid of all my production backups for the last 14 days."
• "Why did backup #28491 fail last night? Show me the error."
• "Trigger the staging database backup now, I'm about to deploy."
• "Pause every MySQL backup for the next hour, I'm doing maintenance."
• "Give me a restore link for the latest successful run of backup #28491."

+Tip

For on-demand actions like running, pausing, or restoring, your agent will confirm the affected backup ids with you before executing. You stay in control.

See real conversationsWatch real workflows, including restore, triage, pre-deploy snapshots, and compliance, running end-to-end inside the chat.›

Security and permissions

The MCP server treats your data the same way the SimpleBackups dashboard does.

• No credentials are ever returned. Storage access keys, SSH private keys, database passwords, and API tokens stay inside SimpleBackups. Tool responses never include them, even when listing storages or servers.
• OAuth, not API keys. Each AI client gets a short-lived access token scoped to a single team. There is no long-lived secret for you to copy, store, or rotate manually.
• Restore artifacts are safe to share. Restore prep returns only safe artifacts you act on yourself; your credentials are never sent to the AI client.
• Permissions match your dashboard role. The MCP connection runs with the same role you have on the team you picked at connection time, so an investigative-only teammate stays investigative-only.
• Rate-limited and audited. Every call is rate-limited per caller and logged against your team's audit trail. You can revoke any connection or token from Settings → MCP connections.

SRevoking access

If you ever suspect a connected client has been compromised, revoke the connection from Settings → MCP connections. The access token becomes invalid immediately and the client must re-authenticate to reconnect.

Common questions

Is MCP available on every plan?

The MCP server is currently in private beta. During the beta, access is enabled per account on request.

Does my assistant see my backup data itself?

No. The MCP tools return metadata, including backup configuration, run history, status, and storage destinations, not the contents of your backed-up files or databases. The only exception is restore-prep, which returns a safe restore artifact you can choose to act on; the data itself is fetched by you, not by the assistant.

Can my assistant delete a backup or a storage?

No. Destructive operations like deleting a backup, removing a storage, or rotating credentials are intentionally not exposed over MCP. The only actions available are running, pausing, resuming, and preparing restores, all of which are reversible or read-only.

Can I connect more than one AI client to the same SimpleBackups account?

Yes. Each client registers as a separate MCP connection and gets its own access token. You can see all connected clients in Settings → MCP connections and revoke any of them individually.

Can I choose which team a connection acts on?

Yes. If you belong to multiple SimpleBackups teams, you pick the team during the OAuth consent step. The connection is then bound to that team for its lifetime. To act on a different team, add a second connection.

What if my MCP client does not support OAuth?

Most modern MCP clients support OAuth 2.1 with Dynamic Client Registration out of the box. If yours does not, contact us and we'll help you find a workable path or let you know when client support catches up.

Manage MCP connectionsView, audit, and revoke the AI clients connected to your SimpleBackups account.›