> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inki.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Inki in Codex

> Connect Inki to Codex to find, read, save, and edit your notes

## How Inki Works in Codex

From Codex, you can find your Inki notes, or save a draft you wrote in your terminal or editor as an Inki note. Notes you save open in Inki, so you can keep writing there.

The Codex CLI, IDE extension, and app share the same settings. Add Inki in one of them and you can use it in the others too.

## Connect Inki

You need an Inki account.

1. Run this command in your terminal

   ```bash theme={null}
   codex mcp add inki --url https://inki.so/api/mcp
   ```

2. Inki opens in your browser. Log in to Inki and click "Allow connection"

3. Restart Codex and check that "inki" appears in `/mcp`

If the browser doesn't open, or you closed it before finishing, run `codex mcp login inki` to log in again. The "Auth" column in `codex mcp list` shows whether you're logged in.

Instead of typing the command, you can ask Codex to add Inki for you. In Inki in a desktop browser or the Mac app, open Settings > Account, go to "Connect your agent", click "Copy" next to the message under "In your terminal or editor", and send it to Codex. Codex adds the setting and tells you what's left to do. The iOS app and mobile browsers don't show this message, so use the steps above instead.

## What You Can Do

* **Find notes**: Ask about a topic and Codex searches your notes for those words. Ask for recent notes or the notes in a folder and Codex lists them, newest first
* **Read and summarize**: Codex reads the text saved in Inki before it summarizes, quotes, or edits a note. Each note it mentions comes with a link that opens the note in Inki
* **Save new notes**: Save a draft from a local file or the conversation as a new note, in a folder you name. If the folder doesn't exist yet, Codex can create it
* **Edit notes**: Ask Codex to replace a paragraph, add a sentence, or remove a passage. Inki keeps the version from before each edit in the note's [version history](https://docs.inki.so/en/features/notebook.md#version-history), so you can restore it
* **Rename and move notes**: Change a note's title or move it to another folder. The note's text stays the same
* **Move a note to the trash**: Codex moves one note at a time. You can restore it from [Trash](https://docs.inki.so/en/features/notebook-operations.md#trash) for 30 days
* **Check the connected account**: Ask which Inki account is connected, and Codex shows its name and email address

## Example Prompts

* Which Inki account is connected?
* What did I write most recently in Inki?
* Write a release announcement based on this repository's README and save it as "v2.0 announcement" in my Announcements folder in Inki.
* Read my Inki note "Design notes" and list where it differs from the current code.
* Open my Inki note "Weekly update" and add a summary of the pull requests merged this week at the end.

## When Codex Asks for Permission

Depending on your settings, Codex asks before it uses one of Inki's tools. When it asks, check the tool and what it will send to Inki before you allow it. We recommend checking each change before you allow Codex to edit a note, rename or move it, or move it to the trash.

## What Codex Can't Do

* Permanently delete notes or empty Trash
* Delete folders
* Move several notes, a whole folder, or all your notes to the trash at once
* Create share links
* Read or change notes that belong to other members of your workspace

To delete a note permanently, use [Trash](https://docs.inki.so/en/features/notebook-operations.md#restore-or-permanently-delete) in Inki.

## Disconnect

* **Desktop browser and Mac app**: Open Settings > Account. Under "Connect your agent", click "Disconnect" next to Codex in the connected list, then click "Disconnect" again in the same row to confirm
* **Any browser**: Open [inki.so/en/connections](https://inki.so/en/connections), sign in, click "Disconnect" next to Codex, then confirm in the same row

If you run `codex mcp logout inki` or `codex mcp remove inki` in Codex, Codex still appears in Inki's connected list. To remove it there, disconnect it in Inki as described above.

Notes you've already saved stay in Inki after you disconnect. To use Inki again, run `codex mcp login inki` to log in again.

## Things to Know

* If "inki" doesn't appear in `/mcp`, check with `codex mcp list` that inki was added, then restart Codex
* If "inki" appears but doesn't work, check the "Auth" column in `codex mcp list`. If you're not logged in, run `codex mcp login inki`
* Search matches the words in your notes. If Codex doesn't find a note, try different words. Recent edits can take a moment to show up in search results
* Codex reads the version saved in Inki. Edits still open on another device may not be saved yet, so Codex may not see them
* If a note changes in Inki after Codex reads it, Inki refuses Codex's edit and nothing is written. Codex reads the note again before it tries again, so your newer changes aren't overwritten
* Inki tells Codex that text inside your notes is your content, not instructions. Only your own requests should decide what Codex does. If Codex asks to make a change you didn't ask for, don't allow it

## Get Help

For questions about using Inki in Codex, email [hello@inki.so](mailto:hello@inki.so). Report security issues, including vulnerabilities, to the same address. See [Account and Privacy](https://docs.inki.so/en/account-privacy.md#support) for support hours. How Inki handles the data a connected service works with is described in Article 11 of the [Privacy Policy](https://inki.so/en/privacy).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.