# nocal-mcp

nocal is a calendar-connected, AI-ready second brain. Connect via MCP to give agents the ability to read, search, and patch your notes database, turning nocal into a living knowledge base your agent …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add nocal/nocal-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list nocal/nocal-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get nocal/nocal-mcp notes_create

# Call a tool
npx -y @smithery/cli@latest tool call nocal/nocal-mcp notes_create '{}'
```

## Direct MCP Connection

Endpoint: `https://nocal-mcp--nocal.run.tools`

**Required config:**
- `token` (query) — Your nocal MCP bearer token. Found in the nocal app under Settings → Agent Integrations.

## Tools (6)

- `notes_create` — Create a new note in the user's nocal workspace. Requires schema_hash from notes_get_schema. Do NOT set aiGenerated att…
- `notes_get` — Fetch a single note by ID. Returns content_pm_json (ProseMirror JSON), content_pm_html (HTML), content_raw (plain text)…
- `notes_get_schema` — Fetch the full live ProseMirror schema and schema_hash. ALWAYS call this before note write tools.
- `notes_list_recent` — List the user's most recently modified notes. Optionally filter by folder.
- `notes_patch` — Apply one or more targeted path-based patches to an existing note. Use command=insert (relative_to path + before/after …
- `notes_search` — Full-text search across the user's notes. Returns ranked results with title and content snippets.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get nocal/nocal-mcp <tool-name>
```