Zotero MCP Server

Your Zotero library: add papers, organize collections and pull notes.

Размещённый MCP-сервер

npx add-mcp 'https://cotlet.dev/mcp/v1/zotero'

Устанавливается в Claude Code, Codex, Cursor и другие

Документация

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Zotero API and MCP server

Zotero has a public Web API v3 with read and write access (checked 16 Oct 2026). You create a key in your zotero.org account settings and send it with each request. The API covers items, collections, tags, notes and exports, but Zotero ships no MCP server, so your agent has to be wired to the API by hand.

Your Zotero library: add papers, organize collections and pull notes. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.

MCP setup REST API guide

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Zotero. Zotero is a trademark of its owner. If Zotero's own integrations cover what you need, use them first.

Reference manager for researchers and students: a library of papers and books with collections, tags, notes and PDF annotations, synced between the desktop app and zotero.org.

What is the Zotero API?

Cotlet's Zotero API exposes 11 endpoints for your own Zotero account: list libraries, search items, get item, list collections, get annotations, export citations, add item by identifier, create collection, add items to collection, add tags and create note. The list_libraries endpoint returns my Library and the group libraries your account belongs to, with their IDs. Each endpoint takes simple JSON inputs like library, collection_key or item_keys and works both as an operation of the zotero_read or zotero_write MCP tool for agents and as a REST call for scripts.

Zotero has a public Web API v3 with read and write access (checked 16 Oct 2026). Cotlet is a hosted MCP server and REST API for Zotero with 11 endpoints (6 read, 5 write): you sign in once in your own cloud browser, your AI agent does the work.

Does Zotero have an official API?

Zotero has a public Web API v3 with read and write access (checked 16 Oct 2026). You create a key in your zotero.org account settings and send it with each request. The API covers items, collections, tags, notes and exports, but Zotero ships no MCP server, so your agent has to be wired to the API by hand.

TaskZotero officialCotlet
Search the libraryYes: Quick search over titles and creators, optional full text, filters by tag and item typeYes
Read items, collections and tagsYesYes
Add an item by DOIPartly: The API writes items from metadata you supply; Add Item by Identifier is a desktop app buttonYes
Create collections and add items to themYes: Items join a collection through their own collections propertyYes
Create notesYes: A note is a child item when parentItem is setYes
Get PDF annotationsPartly: The docs describe children of items and full text of attachments, not annotation itemsYes
Add tags to itemsYesYes
Export citationsYes: BibTeX, BibLaTeX, RIS, CSL JSON and formatted bibliographiesYes

Sources: Zotero Web API v3: basics, Zotero Web API v3: write requests, Zotero Web API v3: full-text content, Zotero: adding items to Zotero

Quick reference

Zotero has a public Web API v3 with read and write access (checked 16 Oct 2026). You create a key in your zotero.org account settings and send it with each request. The API covers items, collections, tags, notes and exports, but Zotero ships no MCP server, so your agent has to be wired to the API by hand.
Cotlet provides a hosted MCP server and REST API for Zotero: 11 tools (6 read, 5 write).
Access       Sign up at https://cotlet.dev/app/signup?app=zotero and request the app in the Cotlet console. ChatGPT and Claude connect with OAuth at https://cotlet.dev/mcp/v1/connect, no API key; code editors and scripts use an API key from the console.

MCP server   https://cotlet.dev/mcp/v1
MCP tools    zotero_read, zotero_write, reads and writes apart; call one with {"operation": "<operation>", "arguments": {...}}
REST base    https://cotlet.dev/api/v1/zotero, each operation at its own route, e.g. POST /api/v1/zotero/item-by-identifiers
Auth         Authorization: Bearer <COTLET_API_KEY>. Listing endpoints and schemas needs no key; calling an endpoint needs one. Over MCP the input schemas come with sign-in.
Operations   list_libraries, search_items, get_item, list_collections, get_annotations, export_citations, add_item_by_identifier, create_collection, add_items_to_collection, add_tags, create_note
Markdown     https://cotlet.dev/integrations/zotero-api-mcp-server.md

How access works:
1. The user signs up at https://cotlet.dev/app/signup?app=zotero and requests Zotero in the Cotlet console.
2. The user signs in to Zotero once in their Cotlet Cloud Browser (their own Chrome in the cloud, opened from the console) and enables Zotero for agents. An agent cannot do this step.
3. ChatGPT and Claude: the user adds https://cotlet.dev/mcp/v1/connect as a connector and signs in to Cotlet (OAuth). Code editors and scripts: an API key from the console goes into the MCP client or the REST call as a bearer token.

Fits: people who want a hosted Zotero server that someone else maintains, including non-developers. Developers who prefer to run and fix code on their own computer can use an open-source Zotero MCP server instead.

Policy: Cotlet never stores passwords and never bypasses MFA.
Company: legal details in the Terms of service at https://cotlet.dev/terms. Contact contact@cotlet.dev.
Sign-in: the user signs in to Zotero in their own Cloud Browser, a Chrome Cotlet runs for them in the EU; password saving is off, the profile is AES-256-GCM encrypted, and agents get Zotero only after the user enables it. Calls are requests from that browser's IP with its cookies, each listed in the user's Background activity. Disable for agents, signing out in the browser or Reset browser cuts access. Cotlet is run by Take Group sp. z o.o. (EU VAT PL6342984273).
API key: holds no Zotero login or cookies, only asks Cotlet to run a tool. Each key is scoped to chosen apps and tools, read only or read and write. Actions that reach other people wait for the user's approval by default, so a leaked key cannot post or message as the user. Every call is in the activity log; deleting the key ends access at once.
Terms: the user stays responsible for following Zotero's terms; Cotlet is not affiliated with Zotero.

What can an AI agent do in Zotero?

Cotlet is best for researchers and students who keep their reading in Zotero and want an AI agent to add papers, sort collections, export BibTeX and write notes without running or fixing a server.

  • Add papers to your library from a list of DOIs (runs: weekly): "Add these DOIs to my Zotero library and put them in the collection "Thesis: related work". Tell me which ones Zotero could not find." → search_items, add_item_by_identifier, add_items_to_collection
  • Export a Zotero collection as BibTeX or a bibliography (runs: weekly): "Export my collection "Thesis: related work" as BibTeX and save it as references.bib. Tell me how many entries it has." → list_collections, export_citations
  • Turn PDF highlights into a literature note (runs: weekly): "Find the Zotero item "Sparse attention for long documents", read its PDF annotations and write one literature note on it with the quotes grouped by color and the page of each." → search_items, get_annotations, create_note
  • Tag and file new papers into collections (runs: weekly): "Look at items in my Zotero library that are in no collection. Tag each by topic and add it to the collection that fits; leave the ones you are unsure about and list them." → search_items, add_tags, add_items_to_collection
  • Send a weekly digest of new library items (runs: weekly): "Every Friday, list the items I added to Zotero in the last 7 days with title, authors and collection, and write me a five-line summary." → search_items, get_item

Can Zotero automations run on a schedule in n8n, Make or Zapier?

Yes. Cotlet does not replace your automation platform: it gives it a Zotero connection it does not have, with the same API key as your agent. Write actions ask for your OK by default; switch that off in your dashboard for the tools you choose, for example to add papers to your library from a list of dois, and the schedule runs on its own. Cotlet runs in the cloud, so it keeps going while your computer is off.

WhereHow to connectHow to schedule
Your AI agentAdd https://cotlet.dev/mcp/v1 with your API key.A scheduled agent run, for example a Claude Code routine.
n8nMCP Client node with https://cotlet.dev/mcp/v1, or an HTTP Request node with the endpoint's method and URL, such as GET https://cotlet.dev/api/v1/zotero/items/search.Schedule Trigger node.
MakeHTTP module: the endpoint's method and URL with an Authorization: Bearer header, and a JSON body for POST, PUT and PATCH.Scenario schedule.
ZapierWebhooks by Zapier, Custom Request: the same method, URL, header and body.Schedule by Zapier trigger.
Your own scriptGET https://cotlet.dev/api/v1/zotero/items/search with your API key.cron or GitHub Actions.

Tools

For AI agents: Every endpoint and its schema is public. The 11 endpoints on this page, with parameters and example responses, can be listed without an account. Calling one returns 401 without an API key and 403 while the key has no access to Zotero.

list_libraries

My Library and the group libraries your account belongs to, with their IDs. Access: read. REST: GET /api/v1/zotero/libraries. MCP: zotero_read → list_libraries.

No parameters.

Returns your personal library first, then each group library with its ID and name. Use the ID as the library parameter of the other read tools. The write tools work on My Library only.

Example response:

{
  "libraries": [
    {
      "library": "me",
      "name": "My Library",
      "type": "personal"
    },
    {
      "library": "4455821",
      "name": "Reading group 2026",
      "type": "group"
    }
  ]
}

search_items

Items in the library matching a phrase, tag, item type or collection, with title, creators, year and tags. Access: read. REST: GET /api/v1/zotero/items/search. MCP: zotero_read → search_items.

ParameterTypeRequiredDescription
librarystringno'me' for My Library (default) or a group library ID from list_libraries.
querystringnoPhrase to find in titles and creators.
full_textbooleannotrue also searches the text of attachments.
tagstringnoOnly items with this tag.
item_typestringnoOnly this item type, e.g. 'journalArticle' or 'book'.
collection_keystringnoCollection key from list_collections.
unfiledbooleannotrue lists only items in no collection.
added_sincedatetimenoOnly items added after this time.
limitintegernoMaximum number of items to return.
cursorstringnoNext page cursor from the previous call.

Searches titles and creators by default; set full_text to include the text of attachments. Filter by tag, item type or collection, or show only items in no collection. Results are items with their keys; use get_item for the fields and notes of one item.

Example response:

{
  "items": [
    {
      "item_key": "H6R2VB5D",
      "title": "Sparse attention for long documents",
      "item_type": "journalArticle",
      "creators": [
        "Lee, M.",
        "Okafor, T."
      ],
      "year": 2025,
      "tags": [
        "transformers"
      ],
      "collections": [
        "C4T8WZ2N"
      ]
    },
    {
      "item_key": "N9Q4XA7E",
      "title": "A survey of retrieval for question answering",
      "item_type": "journalArticle",
      "creators": [
        "Novak, P."
      ],
      "year": 2024,
      "tags": [],
      "collections": []
    }
  ],
  "total": 2,
  "next_cursor": null
}

get_item

One item with all its fields, tags, collections and child notes. Access: read. REST: GET /api/v1/zotero/item. MCP: zotero_read → get_item.

ParameterTypeRequiredDescription
librarystringno'me' for My Library (default) or a group library ID from list_libraries.
item_keystringyesItem key from search_items, 8 characters.

Returns the full metadata of one item as Zotero stores it, the keys of the collections it is in, its tags, and the child notes with their text. PDF attachments are listed by name, not downloaded.

Example response:

{
  "item_key": "H6R2VB5D",
  "item_type": "journalArticle",
  "title": "Sparse attention for long documents",
  "creators": [
    "Lee, M.",
    "Okafor, T."
  ],
  "date": "2025",
  "doi": "10.1234/example.2026.001",
  "tags": [
    "transformers"
  ],
  "collections": [
    "C4T8WZ2N"
  ],
  "notes": [
    {
      "note_key": "T3P6YK8R",
      "text": "Read in October, check the evaluation setup."
    }
  ],
  "attachments": [
    "Lee and Okafor - 2025 - Sparse attention for long documents.pdf"
  ]
}

list_collections

Collections and subcollections of the library with their keys and item counts. Access: read. REST: GET /api/v1/zotero/collections. MCP: zotero_read → list_collections.

ParameterTypeRequiredDescription
librarystringno'me' for My Library (default) or a group library ID from list_libraries.

Returns the collection tree with each key, its parent and the number of items directly in it. Collection names are not unique in Zotero, so use the key and the parent to tell two collections apart.

Example response:

{
  "collections": [
    {
      "collection_key": "C4T8WZ2N",
      "name": "Thesis: related work",
      "parent": null,
      "item_count": 2
    },
    {
      "collection_key": "M2D7FQ4S",
      "name": "Chapter 2",
      "parent": "C4T8WZ2N",
      "item_count": 0
    }
  ]
}

get_annotations

Highlights and comments made in the PDFs of an item, with color and page. Access: read. REST: GET /api/v1/zotero/annotations. MCP: zotero_read → get_annotations.

ParameterTypeRequiredDescription
librarystringno'me' for My Library (default) or a group library ID from list_libraries.
item_keystringyesItem key from search_items, 8 characters.

Returns the annotations of every PDF attached to the item, in page order, each with its text, comment, color and page. Items without a PDF or without annotations return an empty list. It reads annotations only and never changes the PDF.

Example response:

{
  "item_key": "H6R2VB5D",
  "annotations": [
    {
      "type": "highlight",
      "color": "yellow",
      "page": 4,
      "text": "Attention cost grows linearly with window size.",
      "comment": ""
    },
    {
      "type": "highlight",
      "color": "red",
      "page": 12,
      "text": "Evaluation uses one dataset.",
      "comment": "Check the appendix."
    }
  ]
}

export_citations

Items or a whole collection as BibTeX, BibLaTeX, RIS, CSL JSON or a formatted bibliography. Access: read. REST: GET /api/v1/zotero/citations/export. MCP: zotero_read → export_citations.

ParameterTypeRequiredDescription
librarystringno'me' for My Library (default) or a group library ID from list_libraries.
item_keysstring[]noItems to export. Use this or collection_key.
collection_keystringnoCollection key from list_collections.
formatstringyesOne of 'bibtex', 'biblatex', 'ris', 'csljson' or 'bib' (formatted bibliography).
stylestringnoCitation style for format 'bib', e.g. 'apa'.

Exports the items you name, or every item of a collection, in the format you choose. For a bibliography, pass a citation style; otherwise Zotero uses its default. The response holds the text and the number of entries, so you can check nothing was cut.

Example response:

{
  "format": "bibtex",
  "item_count": 2,
  "content": "@article{lee2025sparse,\n  title = {Sparse attention for long documents},\n  author = {Lee, M. and Okafor, T.},\n  year = {2025}\n}\n\n@article{novak2024survey,\n  title = {A survey of retrieval for question answering},\n  author = {Novak, P.},\n  year = {2024}\n}"
}

add_item_by_identifier

Add papers or books to My Library from DOIs, ISBNs, PubMed IDs, arXiv IDs or ADS Bibcodes. Access: write. REST: POST /api/v1/zotero/item-by-identifiers. MCP: zotero_write → add_item_by_identifier.

ParameterTypeRequiredDescription
identifiersstring[]yesDOIs, ISBNs, PubMed IDs, arXiv IDs or ADS Bibcodes.
collection_keystringnoPut the new items in this collection.

Looks up each identifier the way Add Item by Identifier does in the Zotero app and adds one item per match, into the collection you name. Identifiers Zotero cannot resolve come back in not_found and add nothing. It writes to your own library only and runs without asking first: nobody else sees the items and you can remove them in Zotero with Move Item(s) to Trash….

Example response:

{
  "requested": 3,
  "created": [
    {
      "item_key": "H6R2VB5D",
      "title": "Sparse attention for long documents",
      "identifier": "10.1234/example.2026.001"
    },
    {
      "item_key": "N9Q4XA7E",
      "title": "A survey of retrieval for question answering",
      "identifier": "10.1234/example.2026.002"
    }
  ],
  "not_found": [
    "10.9999/broken.2026.7"
  ],
  "collection_key": "C4T8WZ2N"
}

create_collection

Create a collection or a subcollection in My Library. Access: write. REST: POST /api/v1/zotero/collections. MCP: zotero_write → create_collection.

ParameterTypeRequiredDescription
namestringyesCollection name.
parent_collection_keystringnoCreate it under this collection.

Creates a collection with the name you give, at the top level or under a parent collection. Two collections may share a name, so the call returns the new key. It reaches nobody and runs without asking first; delete the collection in Zotero if you do not want it.

Example response:

{
  "collection_key": "M2D7FQ4S",
  "name": "Chapter 2",
  "parent": "C4T8WZ2N"
}

add_items_to_collection

Add items to a collection; they stay in the collections they are already in. Access: write. REST: POST /api/v1/zotero/items-to-collections. MCP: zotero_write → add_items_to_collection.

ParameterTypeRequiredDescription
collection_keystringyesCollection key from list_collections.
item_keysstring[]yesItems to add.

Adds the items to the collection the way dragging them onto it does, so they keep their other collections. It reaches nobody and runs without asking first; Remove Item(s) from Collection… in Zotero undoes it.

Example response:

{
  "collection_key": "C4T8WZ2N",
  "added": [
    "H6R2VB5D",
    "N9Q4XA7E"
  ],
  "already_in_collection": []
}

add_tags

Add tags to one or more items. Access: write. REST: POST /api/v1/zotero/tags. MCP: zotero_write → add_tags.

ParameterTypeRequiredDescription
item_keysstring[]yesItems to tag.
tagsstring[]yesTags to add.

Adds the tags to each item and keeps the tags it already has. It reaches nobody and runs without asking first; removing a tag is a click on the minus button next to it in Zotero.

Example response:

{
  "updated": [
    "H6R2VB5D",
    "N9Q4XA7E"
  ],
  "tags_added": [
    "transformers",
    "to read"
  ]
}

create_note

Add a note to an item, or a standalone note. Access: write. REST: POST /api/v1/zotero/notes. MCP: zotero_write → create_note.

ParameterTypeRequiredDescription
parent_item_keystringnoAttach the note to this item. Omit for a standalone note.
notestringyesNote text.
collection_keystringnoFor a standalone note: put it in this collection.

With parent_item_key the note becomes a child note of that item; without it, a standalone note appears next to the other items. It never changes the item or its PDF, reaches nobody and runs without asking first. Move Item(s) to Trash… in Zotero removes it.

Example response:

{
  "note_key": "T3P6YK8R",
  "parent_item_key": "H6R2VB5D",
  "created_at": "2026-10-16T09:00:00+02:00"
}

How do I connect Zotero to ChatGPT, Claude, Cursor or Codex?

Connecting Zotero takes three steps: sign up, sign in to Zotero once in your Cloud Browser and enable it for agents, then add Cotlet to ChatGPT or Claude as a connector, with no API key, or add one MCP server or call the REST API with an API key.

Connect Zotero to your agent.

  1. Create an account Sign up and add Zotero in the console. ChatGPT and Claude need no API key: you sign in to Cotlet when you add the connector. Code editors and scripts take an API key from the console.

  2. Sign in to Zotero in your Cloud Browser Open your Cloud Browser in the console: your own Chrome in the cloud. Sign in to Zotero there yourself, the way you always do, then press Enable for agents, read only or read and write. We never save your password, and your agent keeps working even when your computer is off.

  3. Add Cotlet to ChatGPT, Claude or your agent Paste the snippet for your client. The same server and key serve every app you connect, so you do this once.

    ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:

claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

Cursor:

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
  1. Ask your agent Ask in plain words. Your agent finds the Zotero tools on the server and calls them for you; anything that reaches other people waits for your OK unless you switch that off for a tool.
Add these DOIs to my Zotero library and put them in the collection "Thesis: related work". Tell me which ones Zotero could not find.

Call Zotero from your scripts.

  1. Export your API key Your scripts use the same API key as your agent. Keep it in an environment variable, never in your code.
export COTLET_API_KEY="cotlet_..."
  1. Call a tool Every tool is an endpoint under /api/v1/zotero with its own method and path, listed with the endpoints above. Path parameters go in the URL; the other parameters go in the query for GET and DELETE and in a JSON body otherwise.
curl -X POST https://cotlet.dev/api/v1/zotero/item-by-identifiers \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identifiers":["10.1234/example.2026.001","10.1234/example.2026.002","10.9999/broken.2026.7"],"collection_key":"C4T8WZ2N"}'
  1. Read the result You get plain JSON back, ready for your script. A failed call costs nothing.
{
  "requested": 3,
  "created": [
    {
      "item_key": "H6R2VB5D",
      "title": "Sparse attention for long documents",
      "identifier": "10.1234/example.2026.001"
    },
    {
      "item_key": "N9Q4XA7E",
      "title": "A survey of retrieval for question answering",
      "identifier": "10.1234/example.2026.002"
    }
  ],
  "not_found": [
    "10.9999/broken.2026.7"
  ],
  "collection_key": "C4T8WZ2N"
}

How to use the Zotero REST API

Create your Cotlet API key

Create a Cotlet API key with access to Zotero and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Connect Zotero in Cotlet and enable it for agents. Account access: Your own zotero.org account with Zotero sync on; the library is the one you already sync from the desktop app.

Make your first Zotero API request

REST:

curl https://cotlet.dev/api/v1/zotero/libraries \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read libraries and apply the operation limits

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "zotero",
  "tool": "list_libraries",
  "result": {
    "libraries": [
      {
        "library": "me",
        "name": "My Library",
        "type": "personal"
      },
      {
        "library": "4455821",
        "name": "Reading group 2026",
        "type": "group"
      }
    ]
  }
}

Returns your personal library first, then each group library with its ID and name. Use the ID as the library parameter of the other read tools.

The write tools work on My Library only.

Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.

Zotero workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestItems in the library matching a phrase, tag, item type or collection, with title, creators, year and tags. Use search_items in your configured workspace report.
MakeHTTP > Make a requestOne item with all its fields, tags, collections and child notes. Use get_item in your configured workspace report.
Python or Node.jsREST APIHighlights and comments made in the PDFs of an item, with color and page. Use get_annotations in your configured workspace report.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads Zotero; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

Why use Cotlet for Zotero?

Built for agents

  • One MCP server for every app you connect.
  • The same tools as a REST API for scripts and cron jobs.
  • Works with ChatGPT, Claude, Claude Code, Codex and Cursor.

Your login stays yours

  • You sign in to Zotero yourself, in your own Cloud Browser. We never save your password; the profile is encrypted with AES-256-GCM, the cipher 1Password uses.
  • A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory.
  • The model never sees a login.
  • No stored passwords, no MFA bypass.

You stay in control

  • Scope each API key: its apps, its tools, read only or read and write.
  • Anything that reaches other people waits for your OK, so a leaked key cannot post or message as you.
  • Every background request listed in your Background activity. Disable for agents in one click.

Kept working for you

  • We test every integration every 6 hours.
  • When Zotero changes, the tool pauses until we fix it.
  • Failed calls cost nothing.

Is it safe to connect Zotero to Cotlet?

Yes. You sign in to Zotero yourself, in your own Cloud Browser, and we never save your password. Your agents only get Zotero once you enable it, and every background request is listed. The browser profile is stored encrypted with AES-256-GCM, the same cipher 1Password uses for its vaults and Apple for iCloud Keychain. Independent public scanners grade cotlet.dev A+ and find it clean; click a result to rerun it yourself.

  • A+ on Qualys SSL Labs: Encryption in transit: TLS setup and certificates, on all four server addresses. Live result
  • A+ on securityheaders.com: Browser protections sent with every page, all six headers present. Live result
  • A+ on Mozilla Observatory: Mozilla's web security baseline: score 120 of 100, 12 of 12 tests passed. Live result
  • Clean on Sucuri SiteCheck: No malware, spam or defacement, and not on any of 9 blocklists, Google Safe Browsing included. Live result

How Cotlet protects your access

Common concerns

Who runs Cotlet?

Cotlet is run by Take Group, a Polish software company working since 2019. Take Group runs about 3,200 websites on its own systems and has its own DevOps team for infrastructure security. We built and used integrations like this inside the company for years before opening them as Cotlet.

Is this an official Zotero integration?

No, Cotlet is independent of Zotero. Zotero's own API is too limited for this work. Cotlet works through your own Zotero account, the way you use Zotero in the browser.

What about client data and GDPR?

Cotlet is run from the EU and follows the GDPR. Cloud Browsers run in Finland, a Tier 1 country in the ITU Global Cybersecurity Index 2024. Data passes through a call and is not kept after it.

Can I start with read only?

Yes. Enable the app for agents as read only, or make the API key read only, and anything that reaches other people waits for your OK unless you switch that off per tool.

Is it reliable?

Every Cotlet service is checked every 3 minutes from Europe, North America, Asia and Australia. The live results and any outage are public at status.cotlet.dev.

How do I stop?

Press Disable for agents next to Zotero in your console: your agents lose access at once and you stay signed in. Signing out of Zotero in the browser works too, and Reset browser deletes the whole profile.

Is there a Zotero MCP server on GitHub?

Yes. Community Zotero MCP servers exist on GitHub, usually maintained by one person, and most need Python or the desktop app running on your computer. You install one, create a Zotero API key, and fix it yourself when Zotero or your Python setup changes. Wiring the Web API into your own script means the same keys and hosting. Cotlet hosts the same tools for you, and our team keeps them working.

GitHub MCP serverCotlet
SetupClone the repo, install Python, create a Zotero API key, add the server to each MCP clientSign up, sign in to Zotero once, add one MCP server or API key
When Zotero changesIt breaks until you or the maintainer fix itOur team tests it daily and fixes it for you; failed calls are free
Your Zotero accessAn API key in a config file on your computer, readable by any program you runSigned in inside your own Cloud Browser in the EU, profile encrypted, only for the apps you enable, disabled for agents in one click
When access expiresTools fail until you create a new key or restart the desktop appYour Cloud Browser keeps you signed in; if Zotero logs you out, your agent gets a link to sign in again
UpkeepYou update dependencies, handle rate limits and debug it yourselfNothing to host or update
Where it runsYour computer, while it is on and Zotero is openHosted: Claude Code, Codex, Cursor, n8n and scripts, also on a schedule
PriceFree, paid for with your timeFree 7-day trial, then pay-as-you-go credit packs, no subscription

Which one fits you

Pick Cotlet if

  • you are not a developer, or you do not want to maintain a server
  • you need it to keep working when Zotero changes, without checking it yourself
  • your agent or a script should run it on a schedule, also while your computer is off

Pick an open-source server if

  • you are comfortable installing, updating and fixing it yourself
  • you want your sign-in to stay on your own computer
  • you only need it now and then, from one MCP client

How much does the Zotero API cost?

Free 7-day trial with 2,000 credits, no card needed. After that, the Zotero API is pay as you go with no limit on apps: Credit packs from $29 for 5,000 credits, one-time, no subscription. A successful call uses 10 to 100 credits (10 for most tools, about $0.04 to $0.06), your Cloud Browser uses 50 credits a day while it has an app enabled for agents, however many apps that is, and an agent driving the browser itself uses 5 credits a minute. Credit packs stay valid for 12 months and stack, so unused credits carry over.

CreditsPrice, one timeCalls at 10 creditsPer 1,000 credits
5,000$29500$5.80
15,000$791,500$5.27
32,000$1493,200$4.66
60,000$2496,000$4.15

Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header. See full pricing

How Cotlet holds your access

Cotlet hosts MCP servers and REST APIs for apps with no usable API. Your agent works in your own Zotero account.

  • Company details: Cotlet is run by Take Group sp. z o.o., a company registered in Poland. Its full address and registration numbers are in the Terms of service. Terms of service
  • Your sign-in: You sign in to Zotero yourself, in your own Cloud Browser: a Chrome we run for you in the EU, one per app. We never save your password (password saving is off), the profile is stored encrypted with AES-256-GCM, and your agents get Zotero only after you enable it. When Zotero signs you out, your agent gives you a link to sign in again. Security
  • Revoking access: Press Disable for agents next to Zotero, sign out of Zotero in your Cloud Browser, or reset the browser. Every background request is listed in your Background activity. Actions that reach other people wait for your OK unless you switch that off per tool.
  • What we never do: Store passwords or bypass MFA.
  • Zotero's terms: You use your own Zotero account and stay responsible for following Zotero's terms. Cotlet is independent and not affiliated with Zotero. Terms
  • Contact: Questions about the company, security or an app: contact@cotlet.dev

Also listed on: Odel, mcpbeat

Zotero API and MCP: questions

How do I get access?

Sign up free, open Zotero in the console and press Activate. Then you create your API key and connect Zotero there.

Do I need to be technical?

No. You sign in to Zotero once in your Cloud Browser, a normal Chrome you open from the console, and paste one command into your agent, or one URL into n8n. Your agent can walk you through it. There is no server to install, update or fix.

Is it safe to connect Zotero to Cotlet?

Yes. You sign in to Zotero yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Zotero once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

Is a hosted server safer than a local one? My Zotero sign-in would leave my computer.

On Cotlet you sign in inside your own Cloud Browser, which only you open, and its profile is stored encrypted with AES-256-GCM in the EU. Agents get only the apps you enable, and every background request is listed. A local server keeps your Zotero cookie in a plain file on your computer, readable by any program you run, and stops when your computer is off.

Why does Cotlet send requests instead of clicking in my browser?

To be fast, Cotlet doesn't click through Zotero's pages. It sends the same requests your browser would, from your browser's IP with its cookies, without opening a window. Zotero sees the same browser and IP you signed in with, and every request is listed in your Background activity.

What if someone gets my Cotlet API key?

The key holds no Zotero login or cookies, it only asks Cotlet to run a tool. It can call only the apps and tools you gave it, and a read-only key changes nothing. Anything that reaches other people, like posts, comments or messages, waits for your OK in the dashboard by default, so a leaked key cannot post or message as you. When you switch approval off for a scheduled job, give that job its own key limited to that one tool. Every call is in your activity log, and deleting the key ends access at once.

Why a signed-in browser and not OAuth, like other integration platforms?

Zotero offers no OAuth token you can simply grant for these tools: its official API leaves them out or needs a developer app, a plan or an approval first (see the official API section above). That is why Cotlet sets the limits itself: per key, per tool, with your approval before anything reaches other people. Cotlet is run by Take Group sp. z o.o., an EU company (VAT PL6342984273).

How do I connect Zotero to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Zotero once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Zotero account through Cotlet, in their phone apps too.

What can ChatGPT do in Zotero?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Zotero: add papers to your library from a list of DOIs; export a Zotero collection as BibTeX or a bibliography; turn PDF highlights into a literature note. You ask in plain words, and anything that reaches other people waits for your OK first.

Do I need Zotero Storage or a paid plan?

No. Cotlet works on your synced library, and data syncing for items, notes, tags and collections is free and unlimited. Zotero Storage matters only for PDF files, where the free quota is 300 MB.

Can the agent work in group libraries?

It can read group libraries you belong to with the library parameter. Writes go to My Library only, so nothing an agent adds appears for other members of a group.

Can my agent post or send messages in Zotero without asking me?

It cannot post or message anyone: no Zotero tool here reaches other people. add_item_by_identifier, create_collection, add_items_to_collection, add_tags and create_note change only your own account and run without asking, and you can undo each in Zotero.

Can I use the Zotero API in n8n?

Yes. Add https://cotlet.dev/mcp/v1 with your API key in n8n's MCP Client node, or call its endpoints under https://cotlet.dev/api/v1/zotero from the HTTP Request node.

Can I use the Zotero API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.