Anytype Toolbox

Automate your Anytype workspace from the terminal, scripts, an external editor,
or an AI client.

The unified binary anyr can manage spaces and objects, work with files and chats,
edit documents in Markdown, export and restore spaces, and run a workflow-oriented MCP server.

The rust client library anytype provides an ergonomic Rust
interface for Anytype's HTTP/REST API and (optionally) the gRPC API for additional capabilities.

Installation | Documentation | Source

Start with `anyr`

Install anyr, then choose the connection that
matches your Anytype installation.

With the Anytype desktop app running, authenticate interactively:

anyr auth login
anyr auth status --pretty

Desktop login provisions HTTP access. auth status reports HTTP and gRPC
credentials separately because some file, chat, invitation, backup, and MCP
operations require gRPC credentials. The credential guide covers both.

For a running Anytype headless server, initialize and verify both credential
families together:

anyr init-cli

Confirm the connection and discover the command surface:

anyr space list --table
anyr --help

The CLI guide covers endpoints, credential storage, output
formats, shell completions, and every command group.

What you can do

Goal	Entry point
Manage spaces, objects, types, properties, files, and chats	`anyr` quick reference
Search and automate Anytype with JSON or table output	`anyr` CLI guide
Edit Anytype documents in an external Markdown editor	`anyr md`
Export a space, collection, type, or tagged selection as Markdown	Markdown export guide
Create, inspect, compare, and restore backups	`anyr backup`
Connect an AI client through the Model Context Protocol	`anyr mcp`
Build an Anytype integration in Rust	`anytype` client library

For example:

# List pages in a space.
anyr object list "Work" --type page --table

# Edit a document after configuring EDITOR or EDITOR_COMMAND.
anyr md edit "Work" OBJECT_ID

# Export a space as Markdown with files and property metadata.
anyr backup export \
  --space "Work" \
  --format markdown \
  --include-files \
  --include-properties \
  --dest ./work-markdown.zip

Commands write compact JSON to stdout by default, which keeps pipelines
predictable. Use --pretty for readable JSON or --table for terminal output.
Diagnostics and progress remain on stderr.

Rust libraries and components

CLI users install anyr. The other workspace packages provide its libraries
and specialized integration surfaces:

Package	Purpose
`anytype` Rust crate	High-level client spanning the supported REST API and selected gRPC capabilities
`anytype-rpc`	Generated low-level client for Anytype's gRPC interface
`any-edit`	Markdown conversion and external-editor workflows used by `anyr md`
`anyback`	Backup, restore, archive inspection, and Markdown export used by `anyr backup`
`any-mcp`	Workflow-oriented MCP server used by `anyr mcp`

The anytype Rust crate is the recommended starting point for applications. It
prefers the supported REST API when REST provides equivalent behavior and uses
anytype-rpc for capabilities that require the gRPC interface.

Build the workspace

The Nix development shell provides the pinned Rust toolchain and native build
dependencies:

nix develop
cargo build
cargo run -- --help

Cargo commands that do not select a package build anyr, the workspace's
default member. Use --workspace or -p PACKAGE to work with every package or
one library.

License

Apache License 2.0. See LICENSE-APACHE.