# Anytype Hermes Skill

> Hermes Agent skill for Anytype MCP integration

- **Type:** MCP server
- **Install:** `agentstack add mcp-foolafroos-anytype-hermes-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Foolafroos](https://agentstack.voostack.com/s/foolafroos)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Foolafroos](https://github.com/Foolafroos)
- **Source:** https://github.com/Foolafroos/anytype-hermes-skill

## Install

```sh
agentstack add mcp-foolafroos-anytype-hermes-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 💎 Anytype — Hermes Agent Skill

> The definitive Hermes Agent skill for interacting with [Anytype](https://anytype.io) via its official MCP server.

[](LICENSE)
[](https://docs.anytype.dev)

---

## Why Anytype?

### 🔒 Your data. Your device. Your rules.

| Feature | Anytype | Notion | Obsidian |
|---|---|---|---|
| **Data ownership** | ✅ 100% local + encrypted sync | ❌ Hosted on their servers | ✅ Local files |
| **End-to-end encryption** | ✅ Built-in (Object Encryption) | ❌ Server-side only | ❌ None |
| **Offline-first** | ✅ Works without internet | ❌ Requires connection | ✅ Local markdown |
| **Vendor lock-in** | ✅ Open format, exportable | ❌ Hard to leave | ✅ Plain markdown |
| **AI training on your data** | ❌ Never | ✅ Yes (ToS allows it) | ❌ No |
| **Decentralized sync** | ✅ IPFS + ActivityPub | ❌ Centralized cloud | ❌ Manual/Git |
| **MCP integration** | ✅ Official server | ⚠️ Community workarounds | ⚠️ Community workarounds |

### The problem with cloud notes

Notion, Evernote, Coda — they all share a dark secret: **your knowledge becomes their training data**. Their terms of service explicitly allow using your content to improve their AI models. That means every thought, every project plan, every private note fuels someone else's LLM.

Obsidian is better — it stores files locally as markdown — but it's still just a file viewer. No native encryption, no decentralized sync, no official MCP server. You're on your own for integrations.

### Anytype does it differently

- **Local-first architecture** — Everything lives on your device first. Sync is optional and encrypted.
- **Object Encryption** — End-to-end encryption means even Anytype's servers can't read your data.
- **Decentralized** — Sync runs over IPFS and ActivityPub. No central database to hack or subpoena.
- **Open MCP server** — Official `@anyproto/anytype-mcp` server lets AI agents interact with your knowledge base securely.
- **No data harvesting** — Their ToS explicitly prohibits using your data for AI training.

> **TL;DR:** Anytype is the only serious knowledge base that respects your privacy AND plays nice with AI agents.

---

## What This Skill Does

This skill enables Hermes Agent to:

- ✅ Create, read, update, and delete Anytype objects (pages, notes, tasks, collections)
- ✅ Search across your entire Anytype knowledge base
- ✅ Manage relations, sets, and views
- ✅ Import/export structured data
- ✅ Execute complex multi-step workflows via JSON-RPC

All operations go through the **official Anytype MCP server** — no reverse-engineered APIs, no community hacks.

---

## Installation

```bash
# Install via Hermes CLI
hermes skills install https://github.com/Foolafroos/anytype-hermes-skill

# Or clone manually
git clone https://github.com/Foolafroos/anytype-hermes-skill ~/.hermes/skills/anytype
```

### Prerequisites

1. An Anytype account with API access
2. Generate an API token in Anytype → Settings → API Keys
3. Install Node.js (for `npx`)

### Configuration

Add your credentials to your Hermes environment:

```bash
export OPENAPI_MCP_HEADERS='{"Authorization":"Bearer ", "Anytype-Version":""}'
```

> 🔐 Your token is never stored by this skill — it's passed as an environment variable per-request.

---

## Quick Start

Once installed, just ask Hermes Agent to interact with Anytype:

```
"Create a new page in Anytype called 'Project Ideas'"
"Search my Anytype for anything about AI agents"
"Update the status of my task to 'In Progress'"
```

The skill handles all the JSON-RPC communication under the hood.

---

## Architecture

```
┌─────────────┐     JSON-RPC      ┌──────────────┐
│  Hermes     │  ──────────────►  │  Anytype     │
│  Agent      │  (via MCP server) │  Local App   │
│  (this skill)│                  │  (encrypted) │
└─────────────┘                   └──────────────┘
                                        │
                                        ▼
                                   ┌──────────────┐
                                   │   IPFS /     │
                                   │ ActivityPub  │
                                   │  (optional   │
                                   │   sync)      │
                                   └──────────────┘
```

---

## References

- [Authentication guide](references/authentication.md)
- [JSON-RPC patterns](references/jsonrpc-pattern.md)
- [Twitter bookmark import example](references/twitter-bookmark-import-2026.md)

---

## Philosophy

This skill was built with one principle: **your knowledge should not be someone else's product**.

Every time you choose a cloud service that mines your data, you lose a little sovereignty. Anytype exists to reverse that trend — and this skill makes it the default knowledge backend for your AI agent.

---

## License

MIT — use it, modify it, share it. Just don't sell your data.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Foolafroos](https://github.com/Foolafroos)
- **Source:** [Foolafroos/anytype-hermes-skill](https://github.com/Foolafroos/anytype-hermes-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-foolafroos-anytype-hermes-skill
- Seller: https://agentstack.voostack.com/s/foolafroos
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
