Setup guide · updated 26 September 2026

Notiero in Codex CLI

Give OpenAI Codex a place to write things down: Notiero keeps its notes, and you read them on any device.

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

codex mcp add notiero --env NOTIERO_API_KEY=nti_your_key_here -- npx -y notiero-mcp

Or edit config.toml

In ~/.codex/config.toml:

[mcp_servers.notiero]
command = "npx"
args = ["-y", "notiero-mcp"]

[mcp_servers.notiero.env]
NOTIERO_API_KEY = "nti_your_key_here"

Try it

Restart Codex CLI, 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

~/.codex/config.toml, or .codex/config.toml inside a trusted project. The Codex IDE extension reads the same file.

Check it works

Run codex mcp list. Notiero should be listed. The tools are write_note, append_to_note, search_notes, read_note and list_notes.

If it does not work

It needs Node.js 18 or newer (node -v).
To avoid writing the key in the file, export it in your shell and use env_vars = ["NOTIERO_API_KEY"] instead of the env table.
"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.

Common questions

How do I give Codex CLI a memory?

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

Can Codex CLI 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 Codex CLI docs on 26 September 2026.