AnyType Skill

Direct integration with AnyType's local REST API. No MCP dependency — uses HTTP calls via a TypeScript CLI tool.

Prerequisites

AnyType desktop app running (provides REST API on localhost)
```
bun
```
runtime installed
API key configured (run Auth workflow if not set up)

Configuration

Per-machine config is resolved in order:

Environment variables:
```
ANYTYPE_API_KEY
```
,
```
ANYTYPE_HOST
```
,
```
ANYTYPE_PORT
```
Config file:
```
~/.config/anytype-skill/config.json
```
Defaults: host=localhost, port=31009

Auto-space: Commands that require a space ID will auto-detect it when you have a single space. Use

--space <id>

to override or when you have multiple spaces.

Tool Location

All operations go through a single CLI tool at

Tools/AnyType.ts

relative to this skill's root directory. Construct the full path based on where this SKILL.md was loaded from.

bun <skill-root>/Tools/AnyType.ts <command> [options]

Workflow Routing

Workflow	Trigger	File
Auth	Set up API key, authenticate, auth status	`Workflows/Auth.md`
Search	Search objects, find notes, query AnyType	`Workflows/Search.md`
Read	Get object, read note, view object details	`Workflows/Read.md`
Tasks	List tasks, create task, mark done, manage tasks	`Workflows/Tasks.md`

Tool Reference

Authentication

Command	Description
`auth challenge`	Start auth flow (4-digit code appears in AnyType)
`auth verify <challenge_id> <code>`	Exchange code for API key
`auth set-key <key>`	Manually set an API key
`auth status`	Check current config and connectivity

Querying

Command	Description
`spaces`	List all spaces
`search --query <text> [--types <t1,t2>] [--sort <prop>] [--direction asc\|desc] [--space <id>] [--limit N]`	Search objects
`get --id <id> [--space <id>]`	Get a specific object
`list [--space <id>] [--limit N]`	List objects in a space
`tasks [--done] [--all]`	List tasks (default: open/uncompleted)

Task Shortcuts

Command	Description
`task-add "name" [--due YYYY-MM-DD] [--body <text>]`	Quick-create a task
`done <task_id>`	Mark a task as complete

Mutating

Command	Description
`create --type <key> --name <name> [--body <md>] [--properties <json>]`	Create an object
`update --id <id> [--name <n>] [--body <md>] [--due DATE] [--properties <json>]`	Update an object
`delete --id <id>`	Archive an object

All commands output JSON to stdout.

--space

is optional for all mutating/querying commands (auto-detected).

Search Behavior

Search
```
query
```
is required and searches object content, not just names
To list all objects of a type, use a space as wildcard:
```
search --query " " --types <type_key>
```
The
```
--types
```
flag filters which object types are returned, not what text is searched
Type keys (e.g.,
```
page
```
,
```
task
```
,
```
note
```
) vary per space — discover them by running a broad search and inspecting the
```
type.key
```
field in results
Objects may contain
```
anytype://
```
links in their markdown body that reference other objects by
```
objectId
```
and
```
spaceId
```
— use these with the
```
get
```
command to follow links

Use

--sort last_modified_date --direction desc

to get most recently modified first

Use
```
--space <id>
```
to scope search to a single space

Property Format Reference

When using

--properties

with

create

update

, match the property format:

Format	JSON Example
checkbox	`{"key": "done", "checkbox": true}`
text	`{"key": "description", "text": "Some text"}`
select	`{"key": "status", "select": {"name": "In Progress"}}`
date	`{"key": "due_date", "date": "2026-03-01T00:00:00Z"}`

Note:

update

also accepts

--due YYYY-MM-DD

as a shorthand for setting the due_date property.

API Quirks

Unchecked checkboxes are omitted: When
```
done
```
is
```
false
```
, the property is absent from the response (not returned as
```
false
```
). The
```
tasks
```
command handles this automatically.
No server-side property filtering: The API filters by type but not property values. The
```
tasks
```
command filters client-side.
Delete = archive: The DELETE endpoint archives objects; they can be restored in AnyType.

Examples

List open tasks:

bun Tools/AnyType.ts tasks

Quick-create a task with due date:

bun Tools/AnyType.ts task-add "Review pull request" --due 2026-03-01

Mark task done:

bun Tools/AnyType.ts done <task_id>

Set a due date on existing task:

bun Tools/AnyType.ts update --id <task_id> --due 2026-03-15

Search with sorting:

bun Tools/AnyType.ts search --query "meeting" --sort last_modified_date --direction desc

Read a specific object:

bun Tools/AnyType.ts get --id <object_id>

Create with full control:

bun Tools/AnyType.ts create --type page --name "Meeting Notes" --body "## Agenda\n- Item 1"

anytype

NPX Install

Tags

SKILL.md Content