# AgentDrive [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/Rakesh1002/agentdrive-mcp  
**GitHub Stars:** 2  
**npm Downloads (last month):** 1831  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/agentdrive-2

## Description
Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.

## Tools
Capabilities this server exposes over MCP:

- **drive_write** — Write a markdown file to a workspace. Creates or updates the file with automatic versioning.
- **drive_read** — Read a file's content from a workspace.
- **drive_list** — List files in a workspace, optionally filtered by path prefix.
- **drive_share** — Generate a share link for a workspace or specific file. Optionally email-gate the link so only a specific person can access it. Humans open this link to view, comment, or edit files.
- **drive_comment** — Add a comment to a file.
- **drive_feedback** — Read human comments on a file. Use this to check if humans have left feedback.
- **drive_activity** — Get recent activity in a workspace (file writes, comments, shares).
- **drive_invite** — Invite a human to your organization by email. The invite stays pending until they sign in and accept it.
- **drive_roles** — Manage per-workspace role delegation. Assign, list, or remove access for specific emails (view/comment/edit).
- **drive_org** — View your organization details: agents, members, plan, and usage.
- **drive_delete** — Delete a file from a workspace.
- **drive_versions** — View version history for a file in a workspace.
- **drive_search** — Semantic search across your org's artifacts in AgentDrive. Returns the top-N most relevant files. Use this BEFORE writing similar artifacts to avoid duplication and surface prior context.
- **drive_recall** — Recall persistent facts and preferences your agents have written. In v1 this returns semantic search results across artifacts; v1.5 will narrow to auto-extracted facts (preferences, decisions, key entities).
- **drive_log_run** — Log an agent run to AgentDrive's provenance store. Captures task, status, referenced/produced artifacts, and cross-platform identity (which agent on which tool). Used for retrospective context retrieval and team-wide audit.
- **drive_context** — Auto-pull the most relevant artifacts from prior agent sessions for the task you are about to do. Combines semantic relevance with recency. Call this at the START of any non-trivial task to ground the agent in prior context — replaces manual copy-paste of artifacts between sessions.
- **drive_sessions** — List recent agent sessions for this project across harnesses (Claude Code, Codex, OpenCode, Gemini CLI, Cursor, Antigravity), newest first. Use to find prior work to continue.
- **drive_resume** — Load a compact handoff brief (goal, files touched, recent turns) from a prior session, by default the latest one from a different harness, so you can continue that work.
- **drive_sandbox_clone** — [EXPERIMENTAL] Clone a git repo into a per-workspace Linux sandbox. Requires Cloudflare Containers on the AgentDrive worker; gracefully degrades to a 503 with "sandbox not configured" otherwise.
- **drive_sandbox_exec** — [EXPERIMENTAL] Run a shell command inside the per-workspace Linux sandbox. Captures stdout/stderr (64 KB cap), exit code, duration. Requires Cloudflare Containers; degrades to 503 otherwise.
- **drive_sandbox_read** — [EXPERIMENTAL] Read a file from the per-workspace sandbox filesystem (build artifacts, test output, logs). Requires Cloudflare Containers; degrades to 503 otherwise.
- **drive_sandbox_commit** — [EXPERIMENTAL] Stage + commit the current sandbox worktree. Surfaces as an AgentDrive artifact at commits/<sha>.json. Requires Cloudflare Containers; degrades to 503 otherwise.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "agentdrive": {
    "command": "npx",
    "args": ["-y","@adrive/mcp-server"],
    "env": {
      "AGENTDRIVE_API_KEY": "",
      "AGENTDRIVE_API_URL": "",
      "AGENTDRIVE_AGENT_PLATFORM": "",
      "AGENTDRIVE_AGENT_ROLE": ""
    }
  }
}
```

**Requires environment variables:** `AGENTDRIVE_API_KEY`, `AGENTDRIVE_API_URL`, `AGENTDRIVE_AGENT_PLATFORM`, `AGENTDRIVE_AGENT_ROLE` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What AgentDrive does

AgentDrive provides a shared, portable workspace for agents operating across different tools and sessions. It stores Markdown artifacts with automatic versioning, supports semantic search and persistent facts, and records which agent platform contributed to a run. Session tools expose recent work and compact handoffs so another harness can continue from the prior goal, touched files, and recent turns.

The workspace also supports human collaboration. Agents can create share links, add comments, read feedback, invite organization members, and manage per-workspace roles. Organization tools expose information about agents, members, plan, and usage.

## How it works

The server can run locally over stdio with the `@adrive/mcp-server` npm package or remotely through `https://mcp.agentdrive.sh/mcp` using Streamable HTTP and bearer-token authentication. A local instance identifies the active project from its working directory, using the Git remote when available and otherwise the repository path. That project identity scopes session listing and resumption.

Agent platform and role values can be supplied to distinguish activity from different runtimes or agent roles. Supported platform labels include Claude Code, Codex, OpenCode, Gemini CLI, Cursor, Antigravity, LangGraph, CrewAI, AutoGen, Hermes, OpenClaw, and `unknown`.

## Setup and configuration

Create an API key through the AgentDrive application, then configure either the hosted endpoint with an `Authorization: Bearer` header or the local command below:

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

The key may also be stored through the AgentDrive CLI configuration at `~/.config/agentdrive/config.json`. Without a key, the server can start with a browser-based connection tool; the complete toolset becomes available after authentication. `AGENTDRIVE_API_URL` can point to a self-hosted worker, while `AGENTDRIVE_AGENT_PLATFORM` and `AGENTDRIVE_AGENT_ROLE` add provenance metadata.

The repository also provides a Claude Code plugin that captures sessions and supports login through `/agentdrive:login`. A shell installer can configure detected hosts automatically.

## Tools and capabilities

- Retrieve relevant prior artifacts, search organization content semantically, and recall saved facts or preferences.
- List project sessions and resume a handoff from another harness.
- Create, read, list, delete, version, share, comment on, and review files.
- Inspect recent workspace activity and log agent runs with task, status, artifacts, and identity data.
- Invite organization members and manage workspace roles.
- Clone a Git repository into a workspace-specific Linux sandbox, execute shell commands, read sandbox files, and commit changes.

## Limitations and notes

The `drive_sandbox_*` tools are experimental and require the Cloudflare Containers plan on the AgentDrive worker. Without that configuration, they return a not-configured response rather than providing the sandbox workflow. The free tier includes one workspace, 1 GB of storage, and 10,000 embeddings.

_Full upstream README: https://allmcps.com/mcp/agentdrive-2/readme_