CLI

Search AI conference papers from the terminal

The official Paperlist command-line client talks to the hosted MCP server at https://paperlist.ai/mcp. Use it yourself in a terminal, or from scripts and coding agents. The open-source project is the client only — not the paper database, and not the Paperlist backend.

Install

Requires Node.js 20 or later. The published package is @paperlist/cli; the command it installs is paperlist.

npm install -g @paperlist/cli
paperlist --help
paperlist --version

Or run it without a global install:

npx @paperlist/cli --help

Try it without signing in

paperlist conferences calls the anonymous list_conferences tool. You can use it immediately after install — no account, no API key.

paperlist conferences
paperlist conferences --json

Then search papers and print JSON

search, paper, papers, similar, topics, and topic-stats need a Paperlist account. Create an API key in dashboard settings, then set PAPERLIST_API_KEY in the environment, or run paperlist login --api-key and paste the key when prompted. Scripts and agents can pipe the key to paperlist login --api-key-stdin. Never pass a real API key as a command-line argument. Open dashboard settings.

Default output is human-readable. Add --json to write a stable JSON document to stdout (diagnostics go to stderr). The CLI does not walk every page on its own; use --cursor when the previous page returns next_cursor.

paperlist search "graph transformers" --json
paperlist search --conference neurips --year-from 2024 --limit 5 --json

For scripts and agents

Prefer the environment variable over a stored login in unattended jobs. Exit codes are stable: 0 success (including empty lists), 1 local error, 2 usage, 3 authentication, 4 rate limited, 5 network or timeout, 6 API or tool error. This CLI does not collect telemetry.

Authentication notes

paperlist login without flags starts a browser OAuth flow only in an interactive terminal. Automated tests cover the client-side flow against a local fixture; a production OAuth login has not been end-to-end verified in the CLI repository. Use an API key for now if you need a reliable sign-in path.

Source and package

GitHub sourcenpm packageGitHub IssuesPaper search MCPMCP tools