---
title: "Niv MCP server"
description: "niv mcp is Niv’s MCP server: it runs on your computer and lets Claude Code, Cursor, Claude Desktop and other MCP apps read a folder’s notes and work with a Space’s databases. Seven tools, no hosted server."
canonical: https://niv.md/mcp
language: en
last_updated: 2026-11-14T17:16:54.000Z
---

# Niv MCP server

niv mcp lets an app that speaks MCP (Model Context Protocol), such as Claude Code, Cursor or Claude Desktop, read a folder’s notes, and read and change a Space’s databases. It is a local server: the app starts it on your computer and talks to it over stdio. It comes with niv, Niv’s command line.

## Local, not hosted

There is no Niv MCP server on the internet to connect to, and there won’t be one that reads your notes: every Space created now is encrypted end to end, so Niv’s servers hold no key to decrypt its notes. (A Space created before encryption stays unencrypted until its owner turns encryption on.) Your keys stay on your device, and niv mcp reads the notes there, as files in a folder on your computer. Nothing to deploy, no key to create.

**What your agent reads through niv goes to its AI provider, under that provider’s terms. That includes notes from an encrypted Space: they’re decrypted on this device, so the provider can read them. Database rows aren’t end-to-end encrypted at all.**

## Set it up

Install niv first: [Niv CLI](https://niv.md/cli).

For Claude Code, add it directly:

```sh
claude mcp add niv -- niv mcp --folder <path>
```

For Claude Desktop, Cursor or another app, this prints what to add to its settings:

```sh
niv mcp config --folder <path>
```

The folder is always named, because an app can start anywhere. It is never your home folder or above it.

## The tools

- `list_notes`: Lists notes by path
- `read_note`: Reads a note, up to 256 KB of text, and says if it cut it
- `search_notes`: Finds notes by words in their title or text, ignoring case. Not semantic
- `list_databases`: Lists a Space’s databases
- `query_rows`: Reads a database’s rows
- `insert_row`: Adds a row
- `update_row`: Changes a row’s cells

Notes are read-only here. To change one, your agent edits its file, and niv sync or the app carries the change.

## What it needs

- Notes need no sync, no keys and no network: they are plain files in the folder. Each answer says whether the folder is being synced, and when it last was.
- Databases need this computer signed in with niv sign-in. Each database tool takes the Space, by name or id.
- It does nothing until a tool is called, and ends when the app closes it. Any number can run, beside niv sync and the app.

More in the docs: [Niv Docs](https://niv.md/docs).

---

More: [Niv](https://niv.md/) · [About](https://niv.md/about) · [Contact](https://niv.md/contact) · [Privacy](https://niv.md/privacy) · [Encryption](https://niv.md/encryption) · [Terms](https://niv.md/terms) · [llms.txt](https://niv.md/llms.txt) · [Português (Brasil)](https://niv.md/pt-br/mcp)
