Documentation

Everything you need to know about using Handrive for privacy-first, peer-to-peer file sharing.

Getting Started

New to Handrive? Start here. Learn how to install, create your first share, and invite members.

InterfacesAI-Native

REST API, MCP, CLI, and Desktop. AI-native design with multiple access methods.

MCP Integration

Connect Handrive to Claude and other AI assistants using the Model Context Protocol.

CLI Reference

Complete command-line reference for shares, files, transfers, and more.

Headless Server

Run Handrive on a NAS, Linux server, or as a background service for always-on access.

ClusteringCluster-Native

Multi-device user clusters and multi-instance local clusters. Scale seamlessly from single device to global deployment.

Troubleshooting

Having issues? Find solutions to common problems with installation, sync, and transfers.

What is Handrive?

Handrive is an AI-native, privacy-first, peer-to-peer file sharing application. Designed from the ground up for both humans and AI agents, every feature is accessible through multiple interfaces: REST API, MCP, CLI, and Desktop.

AI-Native Design

  • MCP Integration: 40+ tools for Claude, GPT, and other AI assistants
  • REST API: Full OpenAPI 3.0 specification with Swagger UI
  • Non-interactive CLI: Commands designed for automation and scripting
  • Consistent interfaces: Same capabilities across all access methods

Cluster-Native Design

  • Multi-device: One email, unlimited devices anywhere in the world
  • Multi-instance: Run multiple instances per machine to maximize hardware utilization
  • Automatic sync: All devices and instances stay in sync automatically

Key Benefits

  • Privacy-first: Your files never leave your devices unless you share them
  • Peer-to-peer: Direct transfers between devices, no cloud middleman
  • Multi-device: Access your shares from any of your devices
  • Collaborative: Share folders with friends and colleagues with fine-grained permissions

Need Help?

If you can't find what you're looking for in the documentation, check out our Support page for FAQs and contact information.