> For the complete documentation index, see [llms.txt](https://docs.papers.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.papers.ai/using-ai/use-papers-ai-from-your-ai-assistant.md).

# Use Papers AI from your AI assistant

Verify and find citations, start, open, read and edit papers, share them and export Word files from Claude, ChatGPT, Claude Code, Codex or Cursor.

Papers AI works inside the assistants you already use. From Claude, ChatGPT, Claude Code, Codex or Cursor you can:

* **Verify citations** against Crossref, so a made-up or mistyped reference is caught before it reaches your paper.
* **Format references** in a citation style (APA, Vancouver, IEEE and more).
* **Start a paper** in Typst, LaTeX or Markdown, and open it in Papers AI.
* **Open your files in Papers AI**: send a folder of drafts to a new project, or add files to one you already have. Word `.docx` files open as editable Word documents.

With the connector (Claude, ChatGPT, and Claude Code with the connector) you can also work on the projects already in your account:

* **List your projects**, with a link to each and when it last changed, so the assistant can find the one you mean.
* **Read a project**: its files, and the text of the ones you ask about. Word documents come back as read-only text.
* **See what changed** in a project since a time: which files, by whom, and a short diff of each.
* **Edit a text file**. Each change is saved as a version labelled with the assistant, and you can restore an earlier one from the file's history. Word documents and binary files cannot be edited.
* **Find references** for a claim: real, citable works with a link to check each one, ready to add to your bibliography. Each request uses one of your plan's daily reference searches.
* **Add references** to a project's bibliography (its `.bib` file, or a new `references.bib`). Nothing already in it is removed, and a work that is already there is not added twice.
* **Share a project**: invite people by email as viewers or editors. Only the project's owner or an admin can share it.
* **Export a Word file**: get a download link for a project's `.docx`, with your latest edits, comments and tracked changes.

Each of these works only on projects and files you can already open in Papers AI, with the same role: a viewer can read but not edit.

You sign in with your Papers AI account. Anything you start or open lands in your account as a cloud project.

### Claude (claude.ai and Claude Desktop)

1. Open **Settings → Connectors → Add custom connector**.
2. Name it `Papers AI` and enter the URL `https://papers.ai/mcp`.
3. Under OAuth client, keep "Use Claude's published identity", which is detected automatically. There is no client ID to enter.
4. Select **Connect** and sign in with your Papers AI account.

On a Claude Team or Enterprise plan, only an organization owner can add a custom connector. Ask yours to add it for the team.

**Tip:** in the connector's tool permissions, set to *Needs approval* the tools that change your account: **Start a paper** and **Open in Papers AI** (they create or add to projects), **Edit a file** and **Add references** (they change files), and **Share a project** (it sends invitation emails, which cannot be unsent). The others only read, but **Read a project** and **Recent changes** send your files' content to the assistant.

### ChatGPT

Open Plugins, then Add → Add custom MCP server. Name it Papers AI, enter the Server URL `https://papers.ai/mcp` and keep Authentication set to OAuth, with no client ID. Confirm the risk notice, select Create as a plugin, then sign in with your Papers AI account.

### Claude Code

You have two options. They give the same tools.

**The plugin.** Adds the Papers AI command-line tool together with a skill that teaches Claude Code when to use it:

```
/plugin install papers-ai --marketplace https://papers.ai/claude/marketplace.json
```

Then install the command-line tool with `npm install -g @papers-ai/cli` and run `papers-ai login` once.

**The connector.** Add it with the URL alone:

```bash
claude mcp add --transport http papers-ai https://papers.ai/mcp
```

Then run `/mcp` in Claude Code, choose `papers-ai`, select **Authenticate** and sign in.

### Codex, Cursor and the terminal

Install the command-line tool (Node 20 or later) and sign in:

```bash
npm install -g @papers-ai/cli
papers-ai login
```

On Windows PowerShell, running `npm` or `papers-ai` may fail with "running scripts is disabled on this system". Use `npm.cmd` and `papers-ai.cmd` instead, or allow local scripts once with `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`.

Codex and Cursor load user skills from `~/.agents/skills`. Copy the skill there once to use it from either client. See the [Codex skills documentation](https://learn.chatgpt.com/docs/build-skills.md) and [Cursor skills documentation](https://cursor.com/docs/skills).

{% tabs %}
{% tab title="macOS and Linux" %}

```bash
mkdir -p ~/.agents/skills
cp -R "$(npm root -g)/@papers-ai/cli/skills/papers-ai" ~/.agents/skills/
```

{% endtab %}

{% tab title="Windows PowerShell" %}

```powershell
New-Item -ItemType Directory -Force -Path "$HOME\.agents\skills"
Copy-Item -Recurse -Path (Join-Path (npm.cmd root -g) '@papers-ai\cli\skills\papers-ai') -Destination "$HOME\.agents\skills\"
```

{% endtab %}
{% endtabs %}

On its own, the tool works like this:

```bash
papers-ai verify refs.bib                          # check every reference against Crossref
papers-ai format dois.txt --style apa              # format a list of references
papers-ai start --title "My paper" --format typst  # start a paper and get its link
papers-ai open ./thesis                            # open a folder in Papers AI
papers-ai compile paper/main.typ                   # Typst to PDF on your machine, no sign-in needed
```

### What is sent to Papers AI

* **Verify and format** send the references you give them, and look them up in Crossref.
* **Start a paper** creates a new project in your account.
* **Open** sends the files you name, Word `.docx` files included. The command-line tool skips what `.gitignore` excludes, and it never sends common credential files (`.env`, private keys, `.npmrc`, `.ssh/`, `.aws/`). A secret stored under another name is still sent, so check the folder first.
* **List** shows the assistant your projects' names, links and when each last changed.
* **Read** and **Recent changes** send the content of the files you ask about, or the diffs, to the assistant. From there, your assistant's own terms apply to them.
* **Edit** and **Add references** send the new text and change the file in your project. Every edit is saved as a version you can restore.
* **Find references** sends the claims you ask about to our reference search.
* **Share** sends an invitation email from Papers AI to each address. Check the addresses first: an invitation cannot be unsent.
* **Export** sends nothing: it gives you a link to download one Word file. The link works for 10 minutes; ask again for a new one. Anyone who has the link before it expires can download that file, so don't share it. The file is made when you open the link, so it has your latest edits.
* Your sign-in is kept in your operating system's keychain (macOS Keychain, Windows Credential Manager, the Secret Service on Linux), never in a plain file. `papers-ai logout` removes it.

### Troubleshooting

| You see                                                                                           | What to do                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| "This server does not serve the Papers AI MCP endpoint"                                           | The connector is not available right now. Try again later.                                                                                                   |
| You are asked to sign in again                                                                    | Your session expired or was revoked. Sign in again (in Claude Code: `/mcp` → Authenticate; in the terminal: `papers-ai login`).                              |
| Sign-in fails, or a connector you added earlier with a Client ID stops working                    | Remove the connector and add it again with the URL alone, as above. In Claude Code, also update to the latest version.                                       |
| "Too many calls. Try again in a minute."                                                          | You hit the per-minute limit. Wait a minute.                                                                                                                 |
| A reference is reported as `mismatch` on its title                                                | A free-text reference must include the paper's title to be confirmed. Add it, or pass the DOI with the authors and year as separate fields.                  |
| "This download link has expired. Ask the assistant for a new one."                                | Export links work for 10 minutes. Ask the assistant to export the file again.                                                                                |
| "This download link is not valid, or you can no longer open the file."                            | The link is incomplete, the file was deleted or moved, or you no longer have access to the project. Check the project in Papers AI, then ask for a new link. |
| "This document has no content to download yet. Open it in Papers AI, then ask again."             | The Word document was never opened in Papers AI. Open it once, then ask again.                                                                               |
| "Exports are busy right now. Try the link again in a moment."                                     | Open the same link again in a minute, while it is still valid.                                                                                               |
| "This document is too large or damaged to export here. Download it from Papers AI."               | Open the project in Papers AI and download the file from the editor.                                                                                         |
| The assistant says you have used today's reference searches                                       | Each plan has a daily number of reference searches; the message names the plan that raises it. Try again after the time it gives.                            |
| "Only the project's owner or an admin can share it."                                              | Ask the project's owner to share it, or to make you an admin.                                                                                                |
| An edit is refused because the text appears more than once, or the file changed since it was read | Ask the assistant to read the file again and retry with a longer, unique piece of text.                                                                      |
