Connect Codex, Claude, ChatGPT, Claude Code, Cursor, and other AI tools to Anara through MCP (Model Context Protocol). Once connected, your AI tool can search and read your library, run structured research workflows, and ask Anara for cited answers without leaving the tool you are already using.

What a connected tool can do

Search files, notes, folders, spreadsheets, and library metadata
Read source passages, complete document pages, tables of contents, notes, and spreadsheet data
Run a full Anara agent for open-ended research and receive citation links that open the supporting passages
For local coding agents, upload files from your computer and combine them with your Anara library

Permissions

Connections are read-only by default. The Anara consent screen may offer an optional write-access checkbox. If you select it, the connected tool can create notes, folders, and spreadsheets, and edit notes and spreadsheets.

Deleting, moving, and renaming library items remains blocked.

Before you start

An Anara account with files in your library
An MCP-compatible AI tool that supports remote Streamable HTTP servers

You sign in through your browser when you connect. There is no client ID or secret to configure, so leave those fields blank if a tool asks for them.

The Anara MCP server URL is:

https://anara.com/api/mcp

Connect from Codex

In your terminal, run:

codex mcp add anara --url https://anara.com/api/mcp

Finish authentication:
```
codex mcp login anara
```
Your browser opens to the Anara consent screen. Review the access, optionally select write access, and click Allow.
Start a new Codex chat. You can verify the connection with:
```
codex mcp list
```

Connect from Claude Code

In your terminal, run:

claude mcp add --transport http anara https://anara.com/api/mcp

Open Claude Code and run /mcp.
Select anara and choose Authenticate.
Review the Anara consent screen, optionally select write access, and click Allow.

Connect from Claude desktop or web

Open Settings > Connectors.
Click Add custom connector.
Name it Anara, enter https://anara.com/api/mcp, and save.
Click Connect, sign in to Anara, review the permissions, and click Allow.
Turn the Anara connector on in a chat.

Connect from ChatGPT

Open Settings > Connectors in a plan or workspace that supports custom MCP connectors.
Add a custom connector with the URL https://anara.com/api/mcp.
Complete the browser sign-in, review the permissions, and click Allow.
Enable or reference Anara in a chat.

Other MCP clients

Anara exposes a remote Streamable HTTP MCP server with OAuth authentication. Any compatible client can connect using https://anara.com/api/mcp.

Primary tools

anara_run_code

Runs one short JavaScript program against the anara.* SDK. Use it for deterministic work such as searching several documents, reading batches of pages, filtering results, querying entities, joining data, or counting records in one call. It runs in an isolated Anara sandbox without access to your computer's files or network.

anara_local_bootstrap

Available to local coding agents such as Codex and Claude Code. It returns a short-lived, scoped credential so the agent can call the Anara API from your computer, for example to upload a local PDF and combine it with your Anara library. The key expires after at most 24 hours and cannot receive permissions that you did not grant to the MCP connection.

anara_spawn_agent

Runs a full Anara agent turn for open-ended work that needs judgment, synthesis, web research, or a written cited answer. You can scope the request to specific documents and optionally choose an available model. The turn is saved as a chat in your Anara workspace, and the result includes links to the saved chat and supporting source passages.

anara_search_library and anara_read_document remain available temporarily for compatibility, but they are deprecated. New workflows should use anara_run_code. The former anara_ask_researcher and anara_critique_result tools have been replaced by anara_spawn_agent.

Troubleshooting

The connector does not show up. Confirm the URL is exactly https://anara.com/api/mcp and that your client supports remote Streamable HTTP MCP servers.
Sign-in did not finish. Disconnect and reconnect the server to restart browser authentication.
The wrong account connected. Sign out of Anara, or use a private browser window, then reconnect with the account whose library you want to use.
The new tools are missing. Reconnect the MCP server, restart the client, or start a new chat so it refreshes its tool list.
A call to anara_ask_researcher or anara_critique_result fails. The client has a stale tool list. Reconnect and use anara_spawn_agent.
A write is refused. Reconnect and grant optional write access on the Anara consent screen. Deletes, moves, and renames remain unavailable.

FAQ

Does the email on my AI tool need to match my Anara email?

No. When you connect, sign in to the Anara account whose library you want the tool to use.

Can a connected tool change my library?

Only if you explicitly grant write access. It can then create notes, folders, and spreadsheets, and edit notes and spreadsheets. It still cannot delete, move, or rename library items through MCP.

Why did an Anara chat appear in my workspace?

anara_spawn_agent saves its turn as an Anara chat so you can open it later and follow its citations. Searches and reads performed through anara_run_code do not create a chat.

Connect AI tools to Anara with MCP