Skip to content
Back to search

mcp-zotero

A connector for Claude Desktop to work with collection and sources on your Zotero Cloud.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kaliaboi--mcp-zotero/badge.svg)](/listings/kaliaboi--mcp-zotero)

HTML

<a href="/listings/kaliaboi--mcp-zotero"><img src="/api/listings/kaliaboi--mcp-zotero/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Get your Zotero credentials:

   # First, create an API key at https://www.zotero.org/settings/keys
   # Then use it to get your user ID:
   curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current

The response will look like:

   {
     "userID": 123456,
     "username": "your_username",
     "access": {
       "user": {
         "library": true,
         "files": true,
         "notes": true,
         "write": true
       }
     }
   }

The `userID` value is what you need.

2. Set environment variables:

   export ZOTERO_API_KEY="your-api-key"
   export ZOTERO_USER_ID="user-id-from-curl"

3. Verify your credentials:

   # Test that your credentials work:
   curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
        "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"

You should see your collections list in the response.

4. Install and run:

   # Install globally (recommended)
   npm install -g mcp-zotero
   mcp-zotero

   # Or run directly with npx
   npx mcp-zotero

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 113 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Zotero
  2. ![NPM Version](https://img.shields.io/npm/v/mcp-zotero) [![smithery badge](https://smithery.ai/badge/mcp-zotero)](https://smithery.ai/server/mcp-zotero)
  3. A Model Context Protocol server for Zotero integration that allows Claude to interact with your Zotero library.
  4. <a href="https://glama.ai/mcp/servers/mjvu0xzzzz"><img width="380" height="200" src="https://glama.ai/mcp/servers/mjvu0xzzzz/badge" alt="Zotero MCP server" /></a>
  5. ## Setup
  6. 1. Get your Zotero credentials:
  7. ```bash
  8. # First, create an API key at https://www.zotero.org/settings/keys
  9. # Then use it to get your user ID:
  10. curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current
  11. ```
  12. The response will look like:
  13. ```json
  14. {
  15. "userID": 123456,
  16. "username": "your_username",
  17. "access": {
  18. "user": {
  19. "library": true,
  20. "files": true,
  21. "notes": true,
  22. "write": true
  23. }
  24. }
  25. }
  26. ```
  27. The `userID` value is what you need.
  28. 2. Set environment variables:
  29. ```bash
  30. export ZOTERO_API_KEY="your-api-key"
  31. export ZOTERO_USER_ID="user-id-from-curl"
  32. ```
  33. 3. Verify your credentials:
  34. ```bash
  35. # Test that your credentials work:
  36. curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
  37. "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"
  38. ```
  39. You should see your collections list in the response.
  40. 4. Install and run:
  41. ```bash
  42. # Install globally (recommended)
  43. npm install -g mcp-zotero
  44. mcp-zotero
  45. # Or run directly with npx
  46. npx mcp-zotero
  47. ```
  48. ## Integration with Claude Desktop
  49. To use this server with Claude Desktop, add the following to your Claude Desktop configuration:
  50. ```json
  51. {
  52. "mcpServers": {
  53. "zotero": {
  54. "command": "mcp-zotero",
  55. "env": {
  56. "ZOTERO_API_KEY": YOUR_API_KEY,
  57. "ZOTERO_USER_ID": YOUR_USER_ID
  58. }
  59. }
  60. }
  61. }
  62. ```
  63. ## Available Tools
  64. - `get_collections`: List all collections in your library
  65. - `get_collection_items`: Get items in a specific collection
  66. - `get_item_details`: Get detailed information about a paper
  67. - `search_library`: Search your entire library
  68. - `get_recent`: Get recently added papers
  69. ## Troubleshooting
  70. If you encounter any issues:
  71. 1. Verify your environment variables are set:
  72. ```bash
  73. echo $ZOTERO_API_KEY
  74. echo $ZOTERO_USER_ID
  75. ```
  76. 2. Check the installation:
  77. ```bash
  78. npm list -g mcp-zotero
  79. ```
  80. 3. Try reinstalling:
  81. ```bash
  82. npm uninstall -g mcp-zotero
  83. npm install -g mcp-zotero
  84. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.