mcpField
A
Armadoc

Armadoc

Local
armadoc.linkFiles & Storage0Updated 3w ago
RepositoryVisit website

About Armadoc

Armadoc is a CLI and local stdio MCP server for end-to-end encrypted document sharing. It lets individuals send and retrieve files while keeping the private key and plaintext on their own machine.

Key features

  1. 01Encrypt local files before sending
  2. 02Send documents to recipients
  3. 03List inbound and outbound documents
  4. 04Decrypt files to a local directory
  5. 05JSON output for scripts

Use cases

  1. 01Share sensitive files with a recipient
  2. 02Retrieve documents received through Armadoc
  3. 03Let an agent list, send, or read documents

MCP support

The local stdio MCP server exposes tools to list, send, and read documents. Reading decrypts files to disk and returns file paths, not document contents.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "link-armadoc-armadoc": {
      "command": "npx",
      "args": [
        "-y",
        "armadoc"
      ]
    }
  }
}
Run commandnpx -y armadoc

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmarmadoc0.2.1

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
directionenumNoOnly this direction; both when omittedinbound | outbound

Details

From the project README

armadoc

The armadoc CLI and a local stdio MCP server for Armadoc end-to-end encrypted document sharing. Send and read documents from a terminal, or let your agent do it as you; the private key and the plaintext never leave your machine.

Install

npm install -g armadoc

Node 24 or later. Or, without a global install, prefix each command with npx.

Pair

armadoc login

This pairs this machine with your Armadoc account in a browser and enrolls a key for it. The key opens only what is sent to you after pairing; anything sent earlier still opens wherever you read it before.

armadoc status shows the pairing.

Send and read

armadoc send report.pdf notes.txt --to [email protected] --to-name "Dustin Burrows"
armadoc ls
armadoc read https://armadoc.link/v/<linkId>

send encrypts the files on this machine and sends them to one recipient, under the name you gave at login. A recipient with no Armadoc key yet is emailed an invite instead and nothing is uploaded; once they accept, run the same send again to complete it. --expires 7d sets how many days the link stays open, within your plan.

ls, or list, shows what is still open in both directions; --inbound or --outbound narrows it. read takes the link from the email or just its id, and saves the files to ~/Downloads/armadoc/<linkId>, or to --dir. It never overwrites a file.

list, read and send take --json for output a script can parse. A refusal, such as a plan limit, goes to stderr with exit code 1.

Use from an agent

Claude Code:

claude mcp add --scope user armadoc -- armadoc mcp

Codex:

codex mcp add armadoc -- armadoc mcp

Any other host: the server is armadoc mcp, over stdio. Restart or reconnect the host to load it.

Requests say whether a command or the MCP server made them, and the server's include the name and version your MCP host reports for itself, so Armadoc can see how the client is used.

The server has to run on your own computer, next to your MCP host. It won't work in cloud-hosted agents, because armadoc login needs a browser on the same machine. Even if it could pair there, your private key and the documents you read would sit on the provider's machines, possibly after the session ends.

Tools

ToolDoes
list_documentsLists documents sent to you and by you
read_documentDecrypts a document's files to disk, by default ~/Downloads/armadoc/<linkId>
send_documentEncrypts local files and sends them, or invites a recipient with no key yet

read_document returns file paths, not contents: what a document says enters the agent's context only if the agent opens the file.

Uninstall

armadoc logout
npm uninstall -g armadoc

armadoc logout deletes the private key and credentials in ~/.config/armadoc. The agent stays on your account until you remove it in settings, and documents it read stay in ~/Downloads/armadoc.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.