---
title: Overview
description: Standalone CLI and MCP server for repo-scoped Markdown notes.
---

`notes` manages repository notes in a Git-backed vault and exposes the same behaviour through a CLI and an MCP server.

**Project notes**

Store Markdown notes under `projects/{owner}/{repo}` using a Git remote or a
local project identity.

**Safe writes**

Reads, writes, and deletes are constrained to the notes vault, then
committed and best-effort pushed.

**Handoffs**

Handoffs are ordinary notes tagged `handoff`, using the same priority
metadata as other notes.

**MCP server**

The same note operations are exposed as raw-text MCP tools for agent
harnesses.

## Start Here

**[Install](/install)**

Install from the AUR or build the binary locally with mise.

**[Quick Start](/quick-start)**

List, read, write, and serve notes over MCP.

**[Notes](/notes)**

Understand the vault layout, frontmatter, and safety model.

**[MCP Server](/mcp-server)**

Expose notes to MCP-compatible agents over stdio.

## Documentation Scope

This repo owns the standalone CLI and MCP server. OpenCode plugins and slash commands that consume `notes` live in dotfiles/OpenCode config.

## Machine-readable docs

| URL                                   | Use                                      |
| ------------------------------------- | ---------------------------------------- |
| https://notes.timmo.dev/llms.txt      | Compact page index                       |
| https://notes.timmo.dev/llms-full.txt | Full docs bundle                         |
| https://notes.timmo.dev/mcp           | Hosted MCP (search, page and navigation) |
| `/{route}.md`                         | One page as Markdown                     |
