# Annotation

> Use this tool when you need to manage notes and tasks in a structured and persistent manner, solving problems of disorganized knowledge bases and todo lists. It provides a JSON file-based storage system for creating, reading, updating, and deleting pages and annotations, with features like bulk operations and automatic UUID generation. Ideal for integrating note-taking and task tracking into AI workflows, allowing for conversational management of personal knowledge bases and todo lists.

Canonical page: https://skillsregistry.net/skills/annotation  
JSON: https://api.skillsregistry.net/v1/skills/annotation

## Description

Annotation MCP server that provides persistent note-taking and task management functionality through a JSON file-based storage system. Built by xmarlon30x2, the implementation offers comprehensive page and annotation management with tools for creating, reading, updating, and deleting pages with associated annotations that can be checked/unchecked like todo items. Features include bulk annotation operations, individual annotation management, and automatic UUID generation for all entities, with data stored locally in a configurable JSON file (defaults to ~/notes.json). Designed for users who want structured note-taking and task tracking capabilities integrated directly into their AI workflows, enabling conversational management of personal knowledge bases and todo lists without requiring external database dependencies.

## Trust

- **Trust score (0–1):** 0.97
- **Verification tier:** verified
- **Last scanned:** 2026-09-19

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** database
- **Updated:** 2026-09-19

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/annotation)
- **Repository:** <https://github.com/xmarlon30x2/annotation-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "annotation"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/annotation` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/annotation/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt