AgentDrive

AgentDrive MCP Server

The official Model Context Protocol server for [AgentDrive](https://agentdrive.sh): shared workspace for coding agents. Capture sessions from Claude Code, Codex, OpenCode, Cursor, Gemini CLI and Antigravity, resume them in any of the others, and search everything they wrote. Provenance on every artifact; portable storage on R2, S3 or your own bucket.

Hit a usage limit in one agent? Call drive_resume in another and it loads the handoff: the goal, the files touched and the latest turns. 22 MCP tools (18 stable + 4 experimental sandbox), over stdio or hosted. Free plan, no credit card.

• Website: https://agentdrive.sh
• Docs: https://agentdrive.sh/docs
• npm: @adrive/mcp-server
• Hosted endpoint: https://mcp.agentdrive.sh/mcp

Claude Code plugin

This repo is also the Claude Code plugin marketplace. The plugin captures every session in the background and resumes it from Codex, OpenCode, Gemini CLI, Antigravity, or Cursor:

/plugin install agentdrive --marketplace agentdrive-sh/agentdrive-mcp

On Claude Code older than 2.1.275, run /plugin marketplace add agentdrive-sh/agentdrive-mcp then /plugin install agentdrive@agentdrive. Sign in with /agentdrive:login.

Get an API key (free)

Create one at https://app.agentdrive.sh — no credit card. The free tier (1 workspace, 1 GB storage, 10k embeddings) is free indefinitely.

Two ways to connect

1. Hosted (no install) — Streamable HTTP

Point any MCP client that supports remote servers at the hosted endpoint and pass your key as a bearer token:

URL:    https://mcp.agentdrive.sh/mcp

Header: Authorization: Bearer agentdrive_live_xxx

Or install in one click via [Smithery](https://smithery.ai/servers/rakesh1002/agentdrive).

2. Local (stdio) — via npx

{

"mcpServers": { "agentdrive": { "command": "npx", "args": ["-y", "@adrive/mcp-server"], "env": { "AGENTDRIVE_API_KEY": "agentdrive_live_xxx" } } } }

Add that block to your host's MCP config:

• Claude Desktop: claude_desktop_config.json
• Cursor: ~/.cursor/mcp.json
• Claude Code: install the plugin (see above), which also captures sessions
• Codex / Cline / Continue / Zed: the standard mcpServers block above

The fastest path is the AgentDrive installer, which auto-wires every detected host:

curl -fsSL agentdrive.sh/install | sh

Configuration

Tools

22 tools across files, memory, sessions, collaboration, org, and provenance. The stdio server derives the current project from its working directory (git remote, else repo path), which scopes drive_sessions and drive_resume.

The drive_sandbox_* tools require the Cloudflare Containers plan on the AgentDrive worker and degrade cleanly to a "not configured" message otherwise.

Why AgentDrive

Agents lose context at every session boundary and every tool switch. AgentDrive is the shared substrate: one workspace, every agent, full provenance. Write once with Claude Code; recall it from Cursor; hand off to Codex — each call is attributed to the right principal and platform.

Develop

npm install

npm run build # tsc -> dist/ npm test # vitest

License

Apache-2.0. See LICENSE.