Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Mendeley CLI

Project description


CLI for Mendeley


pip install mendeley-cli

Docker image is also available.

docker image pull makisyu/mendeley

How to get Mendeley API token

To create, update, and delete resources in your Mendeley library via Mendeley API, OAUTH2 flow is required. We have to register and mark this mendeley-cli as a trusted application in your Mendeley (Elsevier) account by yourself.

1. Register mendeley-cli as a trusted app

Register a new app (if not exists)


All fields are required.

  • Application name: MendeleyCLI
  • Description: MendeleyCLI
  • RegirectURL: http://localhost:8888
    • Port number is a variable; >1024 is recommended.
  • Generate secret, and save it securely.
  • Submit

You got Client ID, Client Secret and Redirect URL.

2. Generate OAUTH2 token

In a terminal, with setting the parameters by environment variables, get token by mendeley get token:


Automatically web browser opens and shows the login page, and please login.

Then, the following messages show:

Login succeeded. You can close this window or tab.
Please follow messages in the terminal to save your token.

Also, the following messages show in the terminal:

Login succeeded.
Please set an environment variable MENDELEY_OAUTH2_TOKEN_BASE64, or add it to a config file:


Now, all parameters to run mendeley_cli is retrieved.

3. Configure mendeley_cli

Save them to configuration file:


The configuration file must be ~/.mendeley_cli/config or <pwd>/.mendeley_cli/config. Alternatively, they can be specified by environment variables directly.

4. All set!


mendeley get documents

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mendeley-cli, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size mendeley_cli-0.1.2-py3-none-any.whl (6.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size mendeley-cli-0.1.2.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page