PaperPush: Automated manuscript submission to journals, conferences, and preprint servers

Prepare manuscripts for submission to preprint servers, venues, and conferences with just a few commands. No need to spend hours filling out forms manually. Just provide a manuscript directory and submission venue of interest, and paperpush will fill out the submission portal for you.

Install

pip install paperpush

To install the playwright dependency and the required chromium browser, run:

playwright install chromium

Use with AI

git clone https://github.com/paperpush/paperpush.git
cd paperpush

Prepare my manuscript in /PATH/TO/MANUSCRIPT/DIRECTORY for submission to VENUE with PaperPush.

The Claude skill /paperpush-prepare-submission helps with this.

See docs/example-session.md for a full worked example of this flow.

MCP server

To drive paperpush from any MCP client — Claude Desktop, an IDE extension — run it as an MCP server:

pip install 'paperpush[mcp]'

{
  "mcpServers": {
    "paperpush": {
      "command": "paperpush-mcp"
    }
  }
}

The server exposes the whole pipeline as tools. See AGENTS.md for the tool list and the contract agents should follow.

Quickstart

1. paperpush subfile VENUE: creates a file VENUE.sub that is a template for the VENUE submission.
2. fill out VENUE.sub - 3 options:
   • a. fill out manually
   • b. Ask an LLM: Use Claude skill /paperpush-autofill, or any AI agent following AGENTS.md.
   • c. paperpush autofill -d /PATH/TO/MANUSCRIPT/DIRECTORY --engine api VENUE.sub: Use an LLM API. Requires an API key.
3. paperpush validate VENUE.sub: run the pre-submission checks on the filled VENUE.sub.
4. paperpush login VENUE: log in to the VENUE submission portal. Public portals without author accounts, such as Combinatorica's EditFlow form, skip this step automatically. Add --orcid to sign in with your ORCID iD and ORCID password instead of a VENUE account, for venues whose portal offers "Sign in with ORCID" (bioRxiv, medRxiv, arXiv, the Cell Press journals, PLOS Computational Biology, BMC Bioinformatics, and Genome Biology so far).
5. paperpush submit VENUE.sub: Fill out the VENUE submission portal. Will not actually submit the manuscript. We highly recommend reviewing the submission form in the venue portal before clicking submit.

See the YouTube tutorial PaperPush Tutorial

Run the whole pipeline at once

scripts/paperpush_pipeline.py sequentially runs the commands above — subfile, autofill, validate, login, submit. This allows going from a manuscript directory to a filled submission portal in just one command.

python scripts/paperpush_pipeline.py -d /PATH/TO/MANUSCRIPT/DIRECTORY --engine api VENUE

See python scripts/paperpush_pipeline.py --help for the full list of options, grouped by step.

Supported venues

Preprint servers: arXiv, bioRxiv, medRxiv

Journals: Bioinformatics, BMC Bioinformatics, Cell, Cell Genomics, Cell Systems, Combinatorica, Discrete Mathematics, Genome Biology, Nature, Nature Biotechnology, Nature Methods, Nucleic Acids Research, PLOS Computational Biology, Science, Science Advances, Science Immunology, Science Robotics, Science Signaling, Science Translational Medicine

Conferences: none yet

View the list on the command line with paperpush --venues.

For more details, see venues.md

Documentation

paperpush.readthedocs.io

Adding new venues

See CONTRIBUTING.md for instructions on adding new venues. See DEVELOPMENT.md for tips on adding new venues and running unit tests.

For AI agents

If you are an AI agent asked to submit a manuscript on the user's behalf, read AGENTS.md — or, if you are working from a pip install rather than a clone of this repo, run paperpush --agent-guide, which prints the same document from the copy that shipped with the installed version. It describes how to run the full pipeline while doing your own field extraction (reading the manuscript and writing a values.json for the default --engine manual) rather than relying on the API-backed engine. It also asks the agent to check paperpush login --list before it starts, and to tell you right away if you still need to run paperpush login <venue> yourself — that sign-in is interactive and belongs in your terminal. Claude Code should prefer the /paperpush-prepare-submission and /paperpush-autofill skills, which encode the same contract.

License

This project is licensed under the BSD-2 License - see the LICENSE file for details.

Developed by Joe Rich