Developers

Everything the app can do, your code can do.

A real REST API with an OpenAPI spec, personal access tokens and OAuth apps, a first-class CLI, and MCP for your AI tools. Open by design — because your second brain should never be a walled garden.

Get started → The Harbor CLI

Start here

Four short pages and you know the whole surface — token in hand, first note created.

Getting started

Everything the Harbor app can do, your code can do. Here's your first API call in about five minutes.

Authentication

Two ways in: a personal access token for your own scripts, or an OAuth app for integrations other people install. Both are scoped to exactly what you allow.

Conventions

The shared contract behind every endpoint — so you only have to learn it once.

Errors

One error shape, with a stable, machine-readable code you can branch on.

API reference

Every endpoint, grouped by resource — each with curl, Python, JavaScript, and Go examples.

OAuth & tokens Complete reference for Harbor's auth endpoints: OAuth token grants, the PKCE authorization flow, personal access tokens, and OAuth app management. Notes Create, list, update, append to, export, and delete notes over the Harbor REST API — with Markdown input, list filters, and encryption support. Notebooks & stacks Create, list, update, and delete Harbor notebooks and stacks via REST — including default-notebook promotion, background delete jobs, and stack grouping. Metadata Attach your own small JSON labels to notes, notebooks and stacks, then filter lists and search by them. The limits, the matching rule, and how metadata syncs. Tags Create, nest, rename, and delete hierarchical tags, and attach or detach them on notes — the full reference for Harbor's tag endpoints. Tasks & reminders Create, list, and complete Harbor tasks — due dates, recurrence, priorities — and manage per-note reminders through a simple JSON REST API. Search & OCR Query notes and OCR'd attachments with Evernote-style operators, then fetch per-word bounding boxes to draw highlight overlays on any page. Files & attachments Upload, deduplicate, and download note attachments with Harbor's content-addressed files API — plus on-request audio transcription. Templates & shortcuts Reference for Harbor's templates, sidebar shortcuts, and saved searches — reusable note starting points, pinned sidebar items, and named queries you keep. Sharing Publish a Harbor note as a public, read-only page behind an unguessable link, track views, and revoke it any time — plus no-auth public read endpoints. Trash & history Soft-delete and restore notes, empty the trash, browse per-note version history and audit events, and follow note links and backlinks. Import & export Move notes in and out of Harbor: async ENEX and Obsidian-vault imports with a pollable job, round-trippable ENEX exports by notebook or note, and Markdown archives that import straight back. Sync engine Build a full offline-capable Harbor client: pull the USN change feed, push change envelopes, resolve conflicts, and sync the zero-knowledge keystore. Account & profile Read and update your Harbor profile and preferences, manage the Google connection, check plan usage, and export your whole account as a ZIP.

The machine-readable spec

Harbor serves a live OpenAPI 3 spec, generated from the running server so it never drifts from the real API. Point a client generator at it for a typed SDK in any language.

curl https://app.harbor.my/api/v1/openapi.json Browse it interactively

Tools & your AI

The API is the foundation — these are the doors in. Pick your terminal, your agent, or both.

Open by design

Build on your second brain.

Start free, mint a token in Settings → Developer, and make your first API call before your coffee cools.

Start free

Free plan to start · No credit card