Collaboration

Mendeley MCP Server

Connect your account, then chat with AI to run tools.

Turn Mendeley into an AI research workspace: search your library and the global catalog, clean citation metadata, organize folders, attach PDFs, manage annotations, and coordinate shared group libraries.

Best forAcademic ResearchersPhD StudentsLiterature ReviewResearch Librarians

Try this workflow

Build a literature review shortlist

Search my Mendeley library for papers about retrieval augmented generation, group the strongest matches by theme, and return the citation details, authors, year, source, tags, and any notes that help me decide what to read first.

Managed
30 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

What you can do with Mendeley

Built for

Academic Researchers, PhD Students, Literature Review Teams, Research Librarians

Example workflows

Build a literature review shortlist

Turns a broad topic into a grounded review queue from your existing library.

Try this

Search my Mendeley library for papers about retrieval augmented generation, group the strongest matches by theme, and return the citation details, authors, year, source, tags, and any notes that help me decide what to read first.

Import a discovered paper

Uses catalog discovery for papers that are not already in the library.

Try this

Search the Mendeley catalog for this DOI, show me the returned citation metadata, then create a library document from the best match and tell me which fields were imported.

Clean citation metadata

Improves citation hygiene before exporting references or writing.

Try this

Find documents in my Mendeley library with missing DOI, journal, author, or publication-year fields, rank the records that most need cleanup, and suggest the exact metadata fields to update.

Organize a project folder

Uses download_folder_files instead of per-document metadata loops.

Try this

Download the PDF attachments from my Mendeley literature-review folder and tell me how many files were retrieved.

Context to know first

What can an AI agent do with Mendeley now?

It can search your personal or group library, discover papers in the global catalog, create and update citation records, organize folders, upload or download PDF attachments, manage annotations, and handle trash cleanup.

How is catalog search different from library search?

Catalog search finds global bibliographic records that may not be in your account yet. Library search works on documents already saved in your personal or group Mendeley library.

Can it help with literature reviews and systematic reviews?

Yes. A useful pattern is catalog discovery for new papers, library search for saved papers, folder organization for inclusion sets, and metadata cleanup before exporting or writing.

Related editorial

Mendeley Research Workflows with AI

What agents can now do with Mendeley: catalog discovery, citation cleanup, folders, PDFs, annotations, groups, and trash.

Read article

AI Skill
SKILL.md

Domain knowledge for Mendeley — workflow patterns, data models, and gotchas for your AI agent.

Mendeley

Mendeley is a reference management system for scholarly work. It stores citation metadata separately from uploaded full-text files, organizes records into personal or shared libraries, and supports collaboration through private or invite-only groups.

Data Model

  • Profile — researcher identity, institution, academic status, and disciplines.
  • Catalog records — global bibliographic entries useful for discovery and citation import. Catalog results are not automatically part of a user's library.
  • Documents — library citation records. A document can be personal or group-scoped, can have metadata such as authors, source, identifiers, tags, notes, read/starred state, and can exist without an attached file.
  • Files — binary attachments, usually PDFs, linked to documents. File deletion removes the attachment, not the citation record.
  • Folders — personal or group organization containers. Removing a document from a folder does not delete the document. Deleting a folder does not delete its documents.
  • Groups — shared research libraries. Current group creation should use private or invite-only access; public group creation is blocked by Mendeley.
  • Annotations — reading notes, highlights, and marked regions attached to documents or files.
  • Trash — soft-deleted documents. Restore returns the citation record, but original folder membership is not restored.

Common Workflows

  • Discover a paper in the global catalog by DOI, identifier, title, author, or topic; then create or update a library document from the returned citation metadata.
  • Search personal or group library documents when the paper should already be in the account. Use catalog discovery when the paper may not be in the library yet.
  • Create a document before uploading a PDF; files attach to existing documents rather than replacing document metadata.
  • Organize documents by creating folders, adding document IDs to folders, and removing folder membership when moving between organizational structures.
  • Work in shared libraries by selecting a group and using that group context for documents, folders, annotations, and files.
  • Use soft deletion first for documents that may need recovery. Permanent deletion belongs only after trash review.
  • Folder downloads: when the user wants PDFs from a folder, call download_folder_files with cursor pagination (has_more, next_cursor) until the folder is complete — or list_folder_files first to inspect sizes. Do not loop get_files once per document. Small PDFs return content_base64; larger ones return presigned download_url with spillover: true.

Operational Notes

  • Document IDs, file IDs, folder IDs, annotation IDs, and group IDs identify different object types and are not interchangeable.
  • get_files lists attachment metadata (size, mime type, hash) — it never returns PDF bytes. Use download_file or download_folder_files for binary content.
  • File download returns base64 content and metadata. Large outputs may be delivered as a resource link by the platform.
  • PDF uploads require a target document, filename, MIME type, and base64 content.
  • Group deletion removes a collaboration space. Folder deletion only removes an organization container. File deletion removes an attachment. Document deletion affects the citation record.
  • Catalog search and library search can hit upstream rate limits; narrower identifier lookups or smaller result limits are more reliable than broad keyword searches.

Tools in this Server (30)

Add To Folder

Add a document to a Mendeley folder. Documents can belong to multiple folders. The document must already exist in the user's library (use upsert_docum...

Delete Annotation

Permanently delete a Mendeley annotation. This cannot be undone. The document itself is not affected.

Delete Document

Permanently delete a document from the user's Mendeley library. This cannot be undone. Unlike trash_document (which soft-deletes and allows restore), ...

Delete File

Delete a file attachment from Mendeley. The library document remains; only the uploaded file object is permanently removed and the attachment content ...

Delete Folder

Permanently delete a Mendeley folder. Documents inside the folder are NOT deleted — only the folder itself is removed. The documents remain in the use...

Delete Group

Delete a Mendeley group. This is a destructive collaboration action; use only when the group itself should be removed, not just a document or folder i...

Delete Trashed

Permanently delete a document from Mendeley's trash. Use this only after a document has already been moved to trash; it cannot be restored afterward.

Download File

Download a Mendeley file attachment and return PDF/binary bytes. Requires file_id from list_folder_files or get_files (metadata only). Mendeley return...

Download Folder Files

Download PDF/binary attachments from a Mendeley folder with cursor pagination. Each file on the page returns content_base64 when under the inline size...

Get Annotations

Get annotations (highlights, sticky notes, comments) from the user's Mendeley library. Filter by document_id to see all annotations on a specific pape...

Get Catalog

Search or look up papers in the global Mendeley catalog (crowd-sourced database of millions of academic papers). Two modes: (1) Keyword search — use '...

Get Documents

Get documents from the user's personal Mendeley library (not the global catalog). Pass document_id to retrieve a single document with full metadata, o...

Get Files

List file metadata (PDFs, attachments) in the user's Mendeley library. Returns file size, hash, MIME type, and associated document_id — never PDF byte...

Get Folder Documents

List the document IDs inside a Mendeley folder. Returns an array of {id} objects. To get full document details, pass each ID to get_documents. Use add...

Get Folders

Get folders from the user's Mendeley library. Returns folder name, parent_id (for nested folders), and creation date. To see which documents are insid...

Get Groups

Get Mendeley groups the user is a member of. Groups are shared collections where multiple researchers can collaborate on a reference library. Pass gro...

Get Identifier Types

Get the list of document identifier types recognized by Mendeley (DOI, PubMed ID, ISBN, arXiv, Scopus, etc.). Useful for understanding which identifie...

Get Profile

Get the authenticated user's Mendeley profile. Returns display name, email, institution, academic status, research disciplines, and account verificati...

Get Subject Areas

Get all academic subject areas used in the Mendeley catalog. These categories (e.g. 'Computer Science', 'Physics and Astronomy', 'Medicine and Dentist...

Get Trashed

Get documents in the Mendeley trash. These were soft-deleted with trash_document and can be restored with restore_trashed. Pass document_id to retriev...

List Folder Files

List PDF/file attachments in a Mendeley folder with cursor pagination. Returns file_id, document_id, filename, mime_type, and size_bytes for each atta...

Remove From Folder

Remove a document from a Mendeley folder. The document is NOT deleted — it stays in the library and any other folders. To move a document between fold...

Restore Trashed

Restore a trashed document back to the user's Mendeley library. The citation record returns to the library, but former folder assignments are not rest...

Search Library

Full-text search across the user's personal Mendeley library. Requires at least one of: query, title, author, source, or abstract. Use 'query' for bro...

Trash Document

Move a document to the Mendeley trash (soft delete). The document is not permanently deleted and can be recovered with restore_trashed. The document i...

Upload File

Upload a binary file, usually a PDF, and attach it to an existing Mendeley document. The MCP input is JSON-safe base64; the tool decodes it and sends ...

Upsert Annotation

Add a note or annotation to a Mendeley document, or update an existing one. To add a text note to a paper: provide document_id, type='sticky_note', an...

Upsert Document

Add a paper to the user's Mendeley library or update an existing one. To create: provide title and type (e.g. 'journal'). Use catalog metadata such as...

Upsert Folder

Create or rename a Mendeley folder. To create: provide a name (and optionally parent_id to nest it under another folder). To rename or move: provide f...

Upsert Group

Create or update a Mendeley group, the shared-library container for collaborative documents and folders. Create with name plus optional description, p...

Frequently Asked Questions

What is the Mendeley MCP server?

Mendeley is a reference management software that allows researchers to organize and share research papers, as well as collaborate on research projects. Use it for managing citations and accessing scholarly articles. It provides 30 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Mendeley to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/mendeley. Authentication is handled automatically.

How many tools does Mendeley provide?

Mendeley provides 30 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Mendeley require?

Mendeley uses One-click sign in. Mendeley requires credentials. Connect via MCPBundles and authentication is handled automatically.

What can an AI agent do with Mendeley now?

It can search your personal or group library, discover papers in the global catalog, create and update citation records, organize folders, upload or download PDF attachments, manage annotations, and handle trash cleanup.

How is catalog search different from library search?

Catalog search finds global bibliographic records that may not be in your account yet. Library search works on documents already saved in your personal or group Mendeley library.

Can it help with literature reviews and systematic reviews?

Yes. A useful pattern is catalog discovery for new papers, library search for saved papers, folder organization for inclusion sets, and metadata cleanup before exporting or writing.

Can it manage PDFs attached to Mendeley documents?

Yes. Files are separate from citation metadata: the agent can upload a PDF to an existing document, list file records, download file content as base64, or delete an attachment without deleting the citation record.

Does Mendeley support collaborative group workflows?

Yes. The server can list groups, create or update private and invite-only groups, inspect shared documents and folders, and delete a group when the collaboration space itself should be removed.

What is the safest way to delete Mendeley records?

Treat file deletion, document trash, and permanent trash deletion as separate actions. Soft-delete documents first, review trash, and permanently delete only when the citation record should not be recoverable.

Can it read or summarize every PDF in my account automatically?

It can download file content when the connected account has access, but the best workflow is targeted: find the relevant document, inspect or download the attached file, then summarize the specific paper.

Which IDs are interchangeable in Mendeley?

They are not interchangeable. Document IDs, file IDs, folder IDs, annotation IDs, and group IDs refer to different object types and must be used with the matching tool.

Setup Instructions

Connect Mendeley to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/mendeley

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Mendeley and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Mendeley will appear under Not connected — select it and click Connect to complete OAuth.
Name: Mendeley
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/mendeley
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Mendeley?

Sign in to connect your credentials and start running tools from the chat.

Mendeley MCP Server & Skill — 30 Tools