Mendeley MCP工具

Prerequisites

1. Mendeley Account - Sign up at mendeley.com (uses Elsevier authentication) 2. Mendeley API App - Register at dev.mendeley.com/myapps.html - Sign in with your Elsevier credentials - Click "Register a new app" - Set redirect URL to http://localhost:8585/callback - Select "Authorization code" flow (not Legacy) - Note your Client ID and Client Secret

Installation

Using Docker

docker run -it \
  -e MENDELEY_CLIENT_ID="your-client-id" \
  -e MENDELEY_CLIENT_SECRET="your-client-secret" \
  -e MENDELEY_REFRESH_TOKEN="your-refresh-token" \
  ghcr.io/pallaprolus/mendeley-mcp

Or build locally:

git clone https://github.com/pallaprolus/mendeley-mcp.git
cd mendeley-mcp
docker build -t mendeley-mcp .

Setup

git clone https://github.com/pallaprolus/mendeley-mcp.git
cd mendeley-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Install MCP inspector

npm install -g @modelcontextprotocol/inspector

Quick Start

Example Usage

Once configured, you can ask Claude things like:

• "Search my Mendeley library for papers about transformer architectures"
• "What papers do I have in my 'Machine Learning' folder?"
• "Find the paper with DOI 10.1038/nature14539 and summarize it"
• "Search the Mendeley catalog for recent papers on protein folding"
• "Add this paper to my library: [title, authors, etc.]"
• "Create a folder called 'Systematic Review 2026' in my Mendeley library"
• "Create a subfolder called 'Screening' under folder ID folder-123"
• "Create a folder called 'Weekly Reading' in group group-456"
• "Rename folder folder-123 to 'Included Studies'"
• "Delete folder folder-999 from my Mendeley library"
• "Add document doc-789 to folder folder-123"
• "Move document doc-789 from 'Screening' to 'Included Studies'"
• "Fix the year on doc-456 — it should be 2024, not 2023"
• "What did I highlight in the attention paper?"
• "Export my 'Lit Review' folder as BibTeX"
• "Download the PDF attached to the paper about protein folding"

For direct tool calls in an MCP client or inspector, the folder-management tools accept inputs like:

Create a root folder:

{
  "name": "Systematic Review 2026"
}

Create a subfolder:

{
  "name": "Screening",
  "parent_id": "folder-123"
}

Rename a folder:

{
  "folder_id": "folder-123",
  "name": "Included Studies"
}

Delete a folder:

{
  "folder_id": "folder-999"
}

Add a document to a folder:

{
  "folder_id": "folder-123",
  "document_id": "doc-789"
}

Configuration

Environment Variables

If you prefer not to use mendeley-auth login, you can configure credentials via environment variables:

```bash

Show environment variables for manual config

mendeley-auth show-env

Tool Reference

Troubleshooting