Anytype API skill
An Anyproto skill for the local Anytype REST API v2: search, creating and editing objects, queries, collections and chats.
- 115 ★ on the repository
- Last commit
Extended access
Why this level
- A write key lets an agent change and delete objects in Anytype spaces.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/anytype-api-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- A write key lets an agent change and delete objects in Anytype spaces.
This is third-party code. Review the repository files before installing.
What it does
The Anytype developer portal repository publishes the `anytype-api` skill for agents. The skill describes the local REST API v2 at `http://127.0.0.1:31009`, where the Anytype app must be running. Every call carries `Authorization: Bearer <key>`; keys are created in the app's API key settings. The first call is `GET /v2/auth/whoami`, which shows whether the key is scoped to spaces and whether it is read-only. The data model comes down to six ideas: spaces, objects with properties and blocks, properties addressed by snake_case keys, types, templates and paginated lists. The skill targets scripts, SDK code and curl calls. For interactive notes and tasks it recommends the `anytype` command-line tool. The skill source is maintained in `anytype-heart`, and the site publishes it alongside `llms.txt`.
Who it is for. Anytype users and integration developers who want an agent working with notes and tasks through the local API.
Good fit when
- An agent searches objects across all spaces or within one.
- A script creates pages, tasks and collections with set properties.
- Key permissions are checked with `whoami` before writing.
- An SDK or curl integration is written by an agent that knows the field naming rules.
Not a fit when
- The Anytype app is not running: the API is local.
- Interactive note work is needed, for which the `anytype` command is better.
- Access to someone else's space is needed without an issued key.
Example request
Check key permissions with `whoami`, find all tasks this week in the "Work" space and list them.Limitations
The API is local: the Anytype app must run on the same machine, and the key is created manually in settings, as the API itself mints none. A key may be limited to spaces and read-only mode, so `whoami` is the first call. The repository license is listed as undetermined in GitHub metadata. The skill is published as a file on the developer site with no dedicated install command. An agent holding a write key can change and delete objects, so use a read-only key for checks. The last commit dates from October 2026.
How to disable. Delete the skill `SKILL.md` from the agent directory and revoke the key in Anytype API settings. Objects already created stay in the space.
FAQ
Where does the API run?
Locally at `http://127.0.0.1:31009`, with the Anytype app running.
Where do I get a key?
In the Anytype app, in the API keys section. The API itself creates none.
How do I learn a key's permissions?
Call `GET /v2/auth/whoami`: the `grant` field shows spaces and write mode.
How do lists and pagination work?
Every list takes `offset` and `limit` (default 25, max 1000) and returns `data`, `total` and `has_more`.
What is better for interactive work?
The `anytype` command-line tool: the skill recommends it for notes and tasks while describing HTTP calls itself.
Discussion
No questions or reviews yet.
Related
SkillsOfficial Anytype MCP server: an agent searches, creates and edits objects, lists and types in your knowledge base
Twenty-two standalone skills: Notion, Todoist, Tavily, Context7, image generation, converting documents to Markdown
A tutor for any subject: diagnosis, a study plan, project tasks and mastery checks, with the results saved to Markdown files
cafe3310's personal skill collection: spec-driven project work, reviews, reports, browser, 3D and video in one repository
A set of everyday agent skills: web search, browser automation, Gmail, Google Calendar and Drive, speech transcription and YouTube transcripts
18 portable skills for work where AI is weakest: messy voice input, message tone, small trend tests and safe shipping.
README in short
The README describes the portal, links to guides, API reference and examples, the Raycast and MCP projects, and publishing of the skill and `/.well-known/` files. Local run is `bun run start`.