Your private notes, files, and agents behind one trusted gate.
An open-source personal file space where you and trusted AI agents work from the same tree.

What is NoteGate?

NoteGate is a personal storage boundary for knowledge shared between a person and their AI agents. You manage a familiar file tree in the web app; connected agents use the same Space / Folder / Text / File model through MCP and REST.

• Keep Markdown, JSON, YAML, plain text, images, PDFs, and other files together.
• Read, edit, preview, search, and transfer content without maintaining a second agent-only store.
• Give each user-managed agent read or write access only to the spaces it needs.
• Sign in to the browser with Google SSO. Public API and MCP access use bearer credentials.
• Work across responsive light and dark interfaces.

Screens

Structured text and file-tree workbench	Google-only production sign-in

Run locally

Requirements: Docker, Rust, Node.js, and pnpm.

cp .env.example .env
pnpm install
make dev-infra

Then run the API and dashboard in separate terminals:

cargo run --bin notegate-api
pnpm web:dev

Open http://localhost:5173. For the production-like Docker stack, run make up and open NoteGate or its provisioned Grafana service dashboard with linked search detail and internals detail dashboards.

See the development guide for architecture, configuration, service URLs, and checks.

The source release version is tracked in VERSION. MCP clients can compare it with the running server's me.server_version when diagnosing a stale tool catalog.

Use the CLI

Install the official macOS or Linux binary from the latest GitHub Release. The installer verifies the platform asset checksum and does not register a background service.

curl -fsSL https://github.com/cagojeiger/notegate/releases/latest/download/notegate-cli-installer.sh | sh
export PATH="$HOME/.local/bin:$PATH"
notegate-cli update --check

notegate-cli calls the shared Command API with either a User Device login or an Agent API key:

# User credential
notegate-cli auth login
notegate-cli me

# Or Agent credential
export NOTEGATE_API_KEY='ngk_v2_...'
notegate-cli me
notegate-cli read --schema

# Local or self-hosted NoteGate override
export NOTEGATE_BASE_URL='http://localhost:9191'

See the CLI contract for JSON input, output, exit codes, and current scope.

Documentation

• Product model
• Agent and permission model
• MCP tools
• CLI contract
• Background jobs
• Reconciliation
• UI constraints
• Security model

Project status

NoteGate is open source under AGPL-3.0-or-later and is primarily maintained by one developer.