MCP server

pdrive runs a remote MCP server at https://pdrive.io/mcp. AI agents and MCP-compatible editors can publish, read, and manage documents without any local binary or CLI tool.

Authentication happens via OAuth. On first connection your editor opens a browser for authorization. After that, tokens are managed automatically.

Tools

  • list_accounts - returns your identity and all accounts you belong to. Call this first.
  • get_account - detailed account info including stats and permissions
  • list_projects - lists projects in an account
  • get_project - detailed project info including stats and last activity
  • create_project - creates a new project (requires write scope)
  • list_documents - lists documents in a project
  • get_document - reads the latest version of a document
  • publish_document - publishes a new document or updates an existing one (requires write scope)
  • list_versions - lists all versions of a document
  • get_version - reads a specific version
  • diff_versions - line-level diff between two versions, with addition/deletion counts
  • get_table_of_contents - heading outline of a document for navigation

Resources

Every account, project, and document is exposed as an MCP resource with a pdrive:// URI:

  • pdrive://acme - an account
  • pdrive://acme/docs - a project
  • pdrive://acme/docs/getting-started.md - a document

Resources support subscriptions. Subscribe to a document resource to get notified when new versions are published.

Prompts

  • about_pdrive - what is pdrive and what can I use it for?
  • getting_started - suggested workflow and available actions
  • account_overview - overview of an account's projects, activity, and your permissions
  • project_overview - overview of a project's documents and recent activity

Scopes

  • Read grants access to all listing, reading, and browsing tools
  • Write grants read plus publish_document and create_project

Installation

Add the pdrive MCP server to your editor's config. No binary to install or update.

Claude Code

Run in your terminal (current project):

claude mcp add pdrive --transport http https://pdrive.io/mcp

Or globally (all projects):

claude mcp add pdrive --scope user --transport http https://pdrive.io/mcp

Claude Desktop

Add to claude_desktop_config.json:

{
"mcpServers": {
"pdrive": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://pdrive.io/mcp"]
}
}
}

Cursor

Add to .cursor/mcp.json:

{
"mcpServers": {
"pdrive": {
"url": "https://pdrive.io/mcp"
}
}
}

VS Code / Copilot

Add to .vscode/settings.json:

{
"mcp": {
"servers": {
"pdrive": {
"url": "https://pdrive.io/mcp"
}
}
}
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
"mcpServers": {
"pdrive": {
"url": "https://pdrive.io/mcp"
}
}
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
"mcpServers": {
"pdrive": {
"httpUrl": "https://pdrive.io/mcp"
}
}
}

Amp

Add to ~/.config/amp/settings.json or .amp/settings.json:

{
"amp.mcpServers": {
"pdrive": {
"url": "https://pdrive.io/mcp"
}
}
}

OpenCode

Add to opencode.json:

{
"mcp": {
"pdrive": {
"type": "remote",
"url": "https://pdrive.io/mcp"
}
}
}

Crush

Add to .crush.json or crush.json:

{
"mcp": {
"pdrive": {
"type": "http",
"url": "https://pdrive.io/mcp"
}
}
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.pdrive]
url = "https://pdrive.io/mcp"

LM Studio

Add to LM Studio MCP config:

{
"mcpServers": {
"pdrive": {
"url": "https://pdrive.io/mcp"
}
}
}

Availability

The MCP server is available on all plans. Any authenticated user can connect.