This connects Claude to both your local Zotero instance and the cloud REST API, so you can import papers from DOI lists, manage collections, and search your library without opening the GUI. It hits localhost:23119 when Zotero is running or falls back to api.zotero.org with your API key. The import flow is clever: it fetches BibTeX from doi.org, tries CrossRef if that fails, then POSTs to the connector endpoint. Useful when you have a dozen DOIs from a lit review and want them in Zotero immediately, or when you need to script collection management and tagging. The REST API coverage is thorough, including batch operations, group libraries, and attachment handling, though you'll need to mind version headers for updates.
- skills.sh installs
- 251
- GitHub stars
- 12
- last updated
- Jun 3, 2026
Install
$ npx -y skills add shoei05/claude-code-zotero-skill --skill zotero --agent claude-codeInstalls into .claude/skills of the current project.
Files
Zotero API Skill
Zotero のローカル HTTP サーバー(localhost:23119)および REST API(api.zotero.org)経由で文献管理操作を行う。
前提条件
ローカル API(Zotero 起動中のみ)
Zotero が起動中で、以下の設定が有効であること:
- Zotero > 環境設定 > 詳細 > 「Allow other applications on this computer to communicate with Zotero」にチェック
接続確認:
curl -s http://localhost:23119/connector/ping
REST API(クラウド操作)
環境変数が設定されていること:
ZOTERO_API_KEY: API キー(https://www.zotero.org/settings/keys で作成)ZOTERO_USER_ID: ユーザー ID
接続確認:
curl -s -H "Zotero-API-Key: $ZOTERO_API_KEY" "https://api.zotero.org/keys/current"
コマンド
1. DOI 一括インポート (/zotero import)
/zotero import <DOI1> <DOI2> ...
/zotero import --file <doi_list.txt>
/zotero import --collection "コレクション名"
インポートスクリプト:
bash ~/.claude/skills/zotero/scripts/zotero_import.sh --dois "10.1038/xxx,10.2196/yyy" [--collection "名前"]
処理フロー:
- Zotero 起動確認(
/connector/ping) - 対象コレクション特定(指定なければ現在選択中を使用)
- 各 DOI →
doi.orgから BibTeX 取得(失敗時 CrossRef フォールバック) /connector/import?session=<unique_id>に POST- 結果サマリー表示
2. 手動 BibTeX インポート (/zotero bibtex)
Sponsors
Details
- Repository
- github.com/shoei05/claude-code-zotero-skill
- First seen
- Jun 3, 2026
