sumno-zotero

What it does

• One-way sync. sumno → Zotero. Nothing in Zotero is uploaded to sumno; the plugin never touches items outside the Sumno collection it manages.
• Deduplication by OpenAlex ID stored in each item's Extra field. Safe to re-run; existing items are skipped, not overwritten.
• Built around a public REST endpoint (GET /api/v1/library) authenticated with a Personal Access Token. The token has its own rate limit and can be revoked at any time.

Install

1. 01Make sure you're on Zotero 7 or later (Help → About Zotero). Zotero 6 is not supported.
2. 02Grab the latest .xpi from GitHub Releases.
3. 03In Zotero: Tools → Plugins → ⚙ (gear, top-right) → Install Plugin From File… → pick the .xpi. Restart Zotero.
4. 04Go to sumno.com.br/conta/tokens (sign-in required), generate a Personal Access Token, paste it in Tools → Sumno: Configure token….
5. 05Run Tools → Sumno: Sync library. Items appear in a collection called Sumno, created the first time.

About sumno

sumno is an academic search assistant aimed at Brazilian graduate students — Portuguese-language coverage, ABNT-style references, OpenAlex-backed metadata. The site, pricing and most features are Portuguese-first.

The plugin itself is language-neutral. If you keep a library in sumno (for any reason — its quotas, its cache, its OpenAlex integration), this plugin makes that library a regular Zotero collection. Researchers outside Brazil are welcome to try it; if you do, drop a line so we can size demand for a fuller English experience.

FAQ

Is it safe? What can the token do?

The token authorizes only the public GET /api/v1/library endpoint on sumno. It can't write to your account, change your subscription, view billing, or read other endpoints. Each token has its own 60 req/min rate limit and can be revoked at /conta/tokens.

Will it overwrite items I already curated?

No. Deduplication uses the OpenAlex ID in Extra. Items imported another way are left alone unless they happen to share the exact same openalex: line, which is unusual.

When will there be bidirectional sync?

Only if real demand shows up. The roadmap (in the GitHub README) follows feedback — not a marketing schedule.

Support

GitHub issues are the primary channel: open an issue (best-effort, no SLA — solo maintainer). For account or billing questions you'd rather email, write to suporte@sumno.com.br — replies in English are fine if you write in English.

License

MIT. See LICENSE. Use it, modify it, ship it. No warranty.