# Notes

An agent adds its own bullets to your Notes notebook, on today's page and tagged as its work. Handy when you are tired of re-explaining a project.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: jpwilliams
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jpwilliams/notes-skill
- Updated: 2026-08-20
- HTML: https://affpapa.org/en/nevibecode/mcp/notes

## What it does

Notes is an MCP server for the notebook at notes.jpwilliams.dev. On its own initiative the agent appends bullets to the current day, and they land in the same entity graph as your own writing, carrying the name you gave the connection. Weeks later a project page shows your notes and the agent's side by side, in date order. The next session reads them back, so the context does not have to be rebuilt.

Four tools sit behind it. `list_entities` is the shelf of projects, people and topics. `get_entity` opens one entity with its mentions and open todos. `get_day` returns a day as markdown, `append_note` adds bullets. A skill tells the agent when to reach for them. There is no vector index and no separate store: a memory is a bullet in a notebook you already read, and you can fix it by hand.

Appending is all the server does. Nothing can be edited or deleted, not your text and not the agent's. A correction is a new bullet. A `#tag` pointing at an entity that was never created makes the call fail outright, and since renaming and merging are missing, a typo stays on the wrong shelf for good. You set up a project's entity yourself, once. A Notes account is required, and the connection asks for read access to the whole notebook — that is what the consent screen puts in front of you.

## Requirements
- Remote server: `https://notes.jpwilliams.dev/api/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http notes https://notes.jpwilliams.dev/api/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add notes --url https://notes.jpwilliams.dev/api/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "notes": {
            "url": "https://notes.jpwilliams.dev/api/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "notes": {
            "type": "http",
            "url": "https://notes.jpwilliams.dev/api/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http notes https://notes.jpwilliams.dev/api/v1/mcp
```

## When to use it
- keep session context so a project needs no re-explaining
- see agent notes and your own on one project page
- pull a day as markdown with bullet ids
- check what an agent wrote and when
- cut an agent's access to the notebook instantly

## Example prompts
- Add a bullet about the auth schema decision we just made
- Show me the `billing` project page and its open todos
- What went into the notebook yesterday?

## Similar
- [memory-notes](https://affpapa.org/en/nevibecode/skills/memory-notes.md) — skill · 1300 installs
- [Pinto Notes](https://affpapa.org/en/nevibecode/mcp/pinto-notes.md) — MCP server · ★ 30
- [Samsung Notes](https://affpapa.org/en/nevibecode/mcp/samsung-notes.md) — MCP server · ★ 9
- [Apple Notes](https://affpapa.org/en/nevibecode/mcp/apple-notes.md) — MCP server · ★ 31
- [Sequential Thinking Working Notes](https://affpapa.org/en/nevibecode/mcp/sequential-thinking-working-notes.md) — MCP server · ★ 959
- [memory-curate](https://affpapa.org/en/nevibecode/skills/memory-curate.md) — skill · 1300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md