Mendeley

• 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 — create or import the citation record first. List folders to find folder_id, or create a folder before adding membership. Group library documents can only join folders in the same group — match group_id from the document with the folder's group. If the document is already in the folder, the call succeeds with already_in_folder=true (idempotent).
• 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 moving a document to trash (soft delete with restore), this is irreversible. All annotations and folder memberships for this document are also removed.
• Delete File — Delete a file attachment from Mendeley. The library document remains; only the uploaded file object is permanently removed and the attachment content cannot be restored by this tool.
• 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 user's library and any other folders they belong to.
• 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 inside it.
• 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 a file or folder attachment listing (metadata only). Mendeley returns a redirect to the binary; the tool follows it and returns content_base64, content_type, size_bytes, file_id, and optional file_name for files under the inline size limit. Larger files spill to S3 with a presigned download_url. To download many files from one folder, prefer paginated folder download.
• 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 cap, or spillover: true with download_url (presigned S3 link) for larger PDFs — surface those links to the user. Use has_more and next_cursor to download an entire folder across multiple pages. Prefer this over downloading one attachment at a time per document. To inspect filenames and sizes without downloading bytes, run the paginated folder atta
• 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 paper — useful for summarizing reading notes. Each annotation includes its type, text content, color, and position in the PDF.
• 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 'query' for free-text search or 'title'/'author'/'source'/'abstract' for field-specific search. Supports operators: + (AND), | (OR), - (NOT), quotes for exact phrases. Filter by year range and open_access status. (2) Identifier lookup — use doi, arxiv, pmid, isbn, issn, or scopus for precise retrieval. Returns full metadata (title, authors, year, so
• 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, or omit to list documents. Filter by folder_id, group_id, starred status, or tag. To list every PDF attachment in a folder in one step, prefer the paginated folder attachment listing instead of listing documents and fetching file metadata per document. To download PDF bytes, use a single-file download or paginated folder download — file listing retu
• 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 bytes. To download binary content, pass a file_id for one attachment or use paginated folder download for many files. When inspecting a whole folder, prefer the paginated folder attachment listing instead of one call per document. Filter by document_id to see attachments on one paper.
• Get Folder Documents — List the document IDs inside a Mendeley folder. Returns an array of {id} objects. To get full document details, fetch each id from the library document reader. Add or remove folder membership with the folder membership tools.
• 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 inside a folder, list document IDs for that folder. To create or rename a folder, use folder create/update.
• 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 group_id for detailed info about a specific group (description, disciplines, owner). Use a group_id when listing documents or folders in that group's shared library.
• Get Identifier Types — Get the list of document identifier types recognized by Mendeley (DOI, PubMed ID, ISBN, arXiv, Scopus, etc.). Useful for understanding which identifier formats work in global catalog lookup or in document identifiers when saving library records.
• Get Profile — Get the authenticated user's Mendeley profile. Returns display name, email, institution, academic status, research disciplines, and account verification status. Useful for confirming which account is connected and personalizing interactions.
• Get Subject Areas — Get all academic subject areas used in the Mendeley catalog. These categories (e.g. 'Computer Science', 'Physics and Astronomy', 'Medicine and Dentistry') appear in catalog entry reader statistics, showing how readership is distributed across disciplines.
• Get Trashed — Get documents in the Mendeley trash. These were soft-deleted from the library and can be restored back to the active library. Pass document_id to retrieve a specific trashed document, or omit to list all trashed items.
• 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 attachment on this page, plus documents_without_files for papers with no uploaded PDF. Use has_more and next_cursor to walk the full folder without fetching file metadata per document. This returns metadata only — not PDF bytes. To download content, use paginated folder download or single-file download with a file_id from this listing.
• 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 between folders, add membership on the new folder, then remove membership on the old folder.
• 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 restored.
• Search Library — Full-text search across the user's personal Mendeley library. Requires at least one of: query, title, author, source, abstract, tag, or identifier. min_year and max_year filter results but cannot be the only parameters. Use 'query' for broad searches; field-specific params target one metadata column. Multiple fields default to OR (set use_and=true for AND). Do not combine identifier with query, title, or author — use identifier alone for a DOI lookup. For query text, use quoted phrases for exact
• Trash Document — Move a document to the Mendeley trash (soft delete). The document is not permanently deleted and can be restored from trash. The document is automatically removed from all folders when trashed.

Showing the first 25 tools — full list and schemas: Directory API.