Setup guide · updated 26 September 2026

Notiero in Claude Code

Claude Code can save what you work out together, decisions, fixes, handoffs, into your Notiero notebook, and look it up again next session.

Set it up

Create a key

Sign in at notiero.com, open Settings › For your AI, pick Add and read the AI folder so it can look things up, and press Create a key. Copy it, it is shown once. It is free.

Run one command

This adds Notiero for every project on this computer (--scope user). Use --scope project to share it through the repo instead.

claude mcp add --scope user --env NOTIERO_API_KEY=nti_your_key_here notiero -- npx -y notiero-mcp

Or add it to .mcp.json

For a project file, keep the key out of git by reading it from your shell. Claude Code expands ${NOTIERO_API_KEY} for you.

{
  "mcpServers": {
    "notiero": {
      "command": "npx",
      "args": [
        "-y",
        "notiero-mcp"
      ],
      "env": {
        "NOTIERO_API_KEY": "${NOTIERO_API_KEY}"
      }
    }
  }
}

Try it

Restart Claude Code, then say: "Save this to my Notiero: we use Postgres because we need joins." Later ask: "What did we decide about the database? Check my Notiero."

Where the config lives

User and local scope live in ~/.claude.json (Windows: %USERPROFILE%\.claude.json). Project scope lives in .mcp.json at the repo root.

Check it works

Run claude mcp list. You should see notiero connected. In a session, type /mcp to see its five tools. The tools are write_note, append_to_note, search_notes, read_note and list_notes.

If it does not work

Options go before the name and --. Everything after -- is the command that starts the server.
On Windows, if the server does not start, try -- cmd /c npx -y notiero-mcp.
"Invalid or revoked key": copy the key again, or create a new one in Settings › For your AI.
"Write-only key" when searching: that key can only add notes. Create one with Add and read the AI folder.
Run npx -y notiero-mcp --version in a terminal to check Node can start it.

Add the Claude skill

The server gives Claude the tools. The skill teaches it good habits: what is worth saving, how to title it, and to search before answering from memory.

mkdir -p ~/.claude/skills/notiero && curl -fsSL https://notiero.com/for-your-ai/SKILL.md -o ~/.claude/skills/notiero/SKILL.md

Common questions

How do I give Claude Code a memory?

Connect it to Notiero, a free notebook. Add the notiero-mcp server to Claude Code with your Notiero key. Claude Code can then save notes, add to them, and with a reading key search and read them in later sessions.

Can Claude Code read all my notes?

No. It can only reach the AI folder in your notebook, and it can only read there if you created a key that may read. Locked notes and notes saved as private are never readable. Nothing can be deleted.

Is Notiero free?

Yes. Notiero and the MCP server are free.

Other apps

Claude Code Claude Desktop Cursor VS Code Windsurf Cline Zed Codex CLI Gemini CLI

Everything about keys, the AI folder and the API: the full guide.

Config checked against the Claude Code docs on 26 September 2026.