Can an AI agent write notes to Notiero?

Yes. Create a personal API key in Notiero Settings, For your AI, then use the notiero-mcp server or POST to /api/agent-note. The agent appends notes to your notebook, which you read and search on any device.

How do I connect Claude or Cursor to Notiero?

Add the notiero-mcp MCP server to your client config with your NOTIERO_API_KEY. In Claude Code: claude mcp add notiero -s user -e NOTIERO_API_KEY=nti_... -- npx -y notiero-mcp. It gives the agent write_note, append_to_note, search_notes, read_note and list_notes.

Is there a Claude skill for Notiero?

Yes. Install it in Claude Code from https://notiero.com/for-your-ai/SKILL.md or upload notiero-skill.zip in the Claude app. It teaches Claude when to save a note, how to title it, and to search your notes before answering from memory.

Only a key's hash is stored. Notes are encrypted into your notebook on your device. A key can reach only your AI folder, reading needs a key you allowed to read, locked notes are never shared, and no key can delete. Revoke a key anytime.

N Notiero For your AI

The notebook your AI writes to

Q: How do I give my AI assistant a memory?

Connect it to Notiero, a free notebook. Create a key in Notiero Settings, For your AI, and add the notiero-mcp server or call the API. Your assistant then saves decisions, snippets and summaries as notes you can read and search on any device.

Q: Can the AI read my notes?

Only if you allow it, and only the notes in your AI folder. An add-only key cannot read anything. An add-and-read key can search and read the AI folder and nothing else. No key can delete.

Give your AI a key, and it saves notes into your Notiero notebook. Decisions, snippets, summaries, to-dos. It can add to a running log, and if you allow it, search what it saved before so it remembers across chats. You read everything in a calm app that syncs to every device. No database to run, no glue code.

Your AIClaude, Cursor, or any agent

→

Your keyYou choose: add, or add and read

→

Your notebookYou read it anywhere

Your AI writes, you read

Open Notiero to get a key

What people have their AI save

Decisions. "We picked Postgres because..." so you never ask twice.

Snippets. The command or fix that finally worked.

Summaries. The short version of a long chat or a long doc.

To-dos. What is left for tomorrow, written down before you close the laptop.

Chats get lost and assistants forget between sessions. A note in Notiero stays, syncs to your phone, and you can search it later.

Quickstart

Create a key

In Notiero, sign in, then open Settings › For your AI. Pick Add notes only, or Add and read the AI folder so your AI can look things up. Press Create a key and copy it, it is shown once.

Give it to your AI

Add the Notiero MCP server to your client (below), add the Claude skill if you use Claude, or call the API directly with the key.

Ask your AI to save things

"Save this to my Notiero." The note appears in your notebook the next time you open it.

MCP server recommended

Five tools so Claude, Cursor, Windsurf or any MCP client can save, add to, and look up your notes. In Claude Code, one line:

claude mcp add notiero -s user -e NOTIERO_API_KEY=nti_your_key_here -- npx -y notiero-mcp

In Claude Desktop, Cursor, Windsurf and others, add this to the MCP config:

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

Restart your client, then ask it to "save this to Notiero." Set NOTIERO_API_URL only if you self-host.

The tools

Tool	Arguments	Does	Key
`write_note`	`text`, `title?`, `folder?`, `tags?`, `private?`	Saves a new note in your AI folder. Markdown is fine. Returns its id. With `private: true` (passwords, keys) it goes outside the AI folder so no key can read it back.	any
`append_to_note`	`id`, `text`	Adds text to the end of a note in the AI folder. Good for running logs.	any
`search_notes`	`query`, `limit?`	Finds notes in the AI folder by words, best match first.	read
`read_note`	`id`	Returns one note's full text.	read
`list_notes`	`limit?`	Latest notes in the AI folder.	read

No tool can delete or change what you wrote. The server also tells your AI when to save and to search before answering from memory.

Your AI folder

Everything your AI writes goes into a folder called AI. It is the only part of your notebook a key can ever reach.

Add notes only keys can save and add to notes there. They cannot read anything.
Add and read keys can also search and read the notes in that folder, so your AI remembers what it saved last week.

Want your AI to know something you wrote yourself? Move that note into the AI folder. Want it hidden again? Move it out. Locked notes are never shared, even inside the folder.

Secrets your AI saves for you (a password, an API key) should use private: true. They land outside the AI folder, so even a reading key can never pull them back out.

Claude skill for Claude

The MCP server gives Claude the tools. This skill teaches it good habits: when a note is worth saving, how to title it so you can find it, to search before answering from memory, and to confirm in one line.

Claude Code:

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

Claude app (claude.ai, Desktop): download notiero-skill.zip, then upload it in Settings › Capabilities › Skills. You can also read the skill first.

Or use the API directly

Any language, any agent. Send the note as JSON with your key as a bearer token:

curl https://notiero.com/api/agent-note \
  -H "Authorization: Bearer nti_your_key_here" \
  -H "content-type: application/json" \
  -d '{"title":"From my agent","text":"Remember: rotate the deploy token monthly."}'

A 200 means it is queued for your notebook:

{ "ok": true, "id": "agn-1790350824305-evvbjo", "folder": "AI" }

Add to it later, or search with a key that may read:

curl https://notiero.com/api/agent-note \
  -H "Authorization: Bearer nti_your_key_here" -H "content-type: application/json" \
  -d '{"op":"append","id":"agn-1790350824305-evvbjo","text":"Done on 25 Sept."}'

curl "https://notiero.com/api/agent-note?q=deploy+token" \
  -H "Authorization: Bearer nti_your_key_here"

Endpoints

All on https://notiero.com/api/agent-note with Authorization: Bearer nti_...

Call	Body or query	Returns
`POST` save	`{ "text", "title"?, "folder"?, "tags"?, "private"? }`, text up to 100 KB	`{ ok, id, folder }`
`POST` add to	`{ "op": "append", "id", "text" }`	`{ ok, id }`
`GET` search	`?q=words&limit=10`	`{ total, notes: [{ id, title, folder, snippet, updatedAt, pending }] }`
`GET` read	`?id=agn-...`	`{ note: { id, title, text, folder, updatedAt } }`
`GET` list	`?limit=20`	Latest notes, same shape as search

Errors: 401 invalid or revoked key · 403 write-only key tried to read · 400 empty text · 404 no such note in the AI folder · 413 too large · 429 too many notes waiting (open the app once). GET calls need a key that may read.

How it stays private

Your AI never touches your encrypted notebook. A new note lands in a small server-side inbox, encrypted at rest with a key for your account only, and the Notiero app encrypts it into your notebook on your device. Only the SHA-256 hash of a key is stored, so a leaked store never exposes a usable key.

If you create a key that may read, the app keeps a copy of your AI folder on the server so your AI can search it. That copy is encrypted at rest but the server can open it to answer searches, which is why it holds only that one folder, never a locked note, and nothing at all while you have no reading key. Revoke your last reading key and the copy is deleted.

No key can delete, and a key can only add to notes inside the AI folder. Revoke any key anytime in Settings › For your AI.

Common questions

When does the note show up?

The next time your Notiero app is open (on load, on sign-in, or when you switch back to the tab). It then syncs to all your devices like any note.

What should my agent save?

Anything worth keeping: decisions, code snippets, links, meeting notes, "remember this" items, running logs. It is your second brain that the AI can fill.

Is it free?

Yes. Notiero is free, and writing notes through the API is part of that.

How do I give my AI assistant a memory?

Give it somewhere to write. Connect Notiero with a key, and your assistant can save what matters as a note. Unlike a database or a Notion setup, there is nothing to build, one key and one tool.

Which AI tools work with it?

Any tool that supports MCP servers, such as Claude Desktop, Claude Code, Cursor and Windsurf, through notiero-mcp. Claude also gets a ready skill (above). Anything else that can call a web address can use the API with the same key.

Can the AI read my notes?

Only if you allow it, and only your AI folder. An "add notes only" key cannot read anything. An "add and read" key can read the notes in your AI folder and nothing else. No key can delete.

Can I have more than one key?

Yes, up to ten. Use a separate key per agent or project so you can revoke one without touching the others. Old keys keep working as add-only keys.

Open Notiero