# Armadoc

> Armadoc is a freemium MCP server for files and documents. Send and read end-to-end encrypted documents from your own machine, by agent or CLI. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Web
- **Website:** https://armadoc.link
- **Repository:** https://github.com/waimun/armadoc-cli/tree/HEAD/packages/cli
- **MCP Registry name:** link.armadoc/armadoc
- **Categories:** files and documents, security
- **Listing updated:** 2026-11-15

## About

Armadoc is a document-sharing service built around one job: sending a file to one verified person, encrypted in the browser so the service cannot read it, with a link that expires after 1 to 30 days. Recipients prove who they are with a 6-digit code sent by email or phone and need no account.

This package is the command-line client plus a local stdio MCP server. You pair the machine once with armadoc login, which enrolls a key; the private key and the plaintext never leave your computer. Its read_document tool saves decrypted files to ~/Downloads/armadoc/<linkId> and returns file paths, so a document's contents reach the model only if the agent opens the file.

The README says the server must run next to your MCP host because pairing needs a browser on the same machine, so it does not work in cloud-hosted agents. It needs Node 24 or later. The website advertises 5 free sends a month and a Pro plan with read receipts.

## Features

- **Local key handling:** The private key and plaintext stay on your machine.
- **Expiring links:** Choose a window from 1 to 30 days; the file is then deleted.
- **Verified recipients:** Viewers confirm with a one-time code by email or phone.
- **Up to 15 files per send:** PDF, spreadsheets, documents and images.
- **Script-friendly CLI:** list, read and send take --json for machine-readable output.

## Good for

- Have an agent send a signed contract to a client securely
- Retrieve a document you were sent and save it locally
- List open inbound and outbound shares from a terminal
- Invite a recipient who has no Armadoc key yet

## Install

### Claude Code (Terminal)

```sh
claude mcp add armadoc -- npx -y armadoc
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "armadoc": {
      "command": "npx",
      "args": [
        "-y",
        "armadoc"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "armadoc": {
      "command": "npx",
      "args": [
        "-y",
        "armadoc"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "armadoc": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "armadoc"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "armadoc": {
      "command": "npx",
      "args": [
        "-y",
        "armadoc"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "armadoc": {
      "command": "npx",
      "args": [
        "-y",
        "armadoc"
      ]
    }
  }
}
```

## Tools

- `list_documents`: Lists documents sent to you and by you.
- `read_document`: Decrypts a document's files to disk, by default ~/Downloads/armadoc/<linkId>.
- `send_document`: Encrypts local files and sends them, or invites a recipient with no key yet.

## FAQ

### Does it work in cloud-hosted agents?

No. Pairing needs a browser on the same machine, and the README says keys and documents would otherwise sit on the provider's servers.

### What Node version does it need?

Node 24 or later.

### Does the agent see document contents?

read_document returns file paths; contents enter context only if the agent opens the file.

### Is there a free plan?

The website says 5 free sends a month.

### Is Armadoc free?

Armadoc has a free plan, with paid plans for more usage or features.

### How do I add Armadoc to Claude Code?

Run this command in your terminal: claude mcp add armadoc -- npx -y armadoc

### What are the best alternatives to Armadoc?

The closest alternatives to Armadoc are REA, Agent Roast, Midplane, Leash and ASTra.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/armadoc
