logseq-zotero-sync

Tag Zotero items referenced in Logseq pages with the in_logseq tag.

1|Updated Oct 26, 2025
One-click install
npx skills add https://github.com/kerim/logseq-zotero-sync --skill logseq-zotero-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: logseq-zotero-sync
Source: https://github.com/kerim/logseq-zotero-sync/tree/main/skill
Command: npx skills add https://github.com/kerim/logseq-zotero-sync --skill logseq-zotero-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Logseq users who want to keep Zotero items in sync with their notes can automate tagging of referenced items with in_logseq, reducing manual effort and keeping bibliographic references organized.

Core Features & Use Cases

  • Batch-checks Logseq pages for Zotero URLs and applies in_logseq only to items that lack the tag.
  • Parses Zotero URLs to extract item keys and updates Zotero accordingly.
  • Idempotent operation that safely re-runs without duplicating tags.
  • Supports credential sharing via macOS Keychain and uses the Logseq CLI for data extraction.

Quick Start

Run python sync_logseq_to_zotero.py from the project directory to start syncing your Logseq graph to Zotero.

Frequently Asked Questions about logseq-zotero-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically tag Zotero items referenced in my Logseq notes?

You can automatically tag Zotero items by running a sync script that parses Logseq pages for Zotero URLs, extracts item keys, and batch applies the in_logseq tag to corresponding Zotero entries using PyZotero.

What is the best way to sync Logseq literature notes with Zotero?

The best way to sync Logseq literature notes with Zotero is using an idempotent, batch-based approach that checks Logseq pages for Zotero URLs and applies the in_logseq tag only to new items, preventing duplicate tags on re-runs.

Can I use macOS Keychain to store credentials for Zotero and Logseq automation?

Yes, you can use macOS Keychain to store credentials for Zotero and Logseq automation. The sync process supports credential sharing via macOS Keychain to securely authenticate PyZotero and Logseq CLI operations.

Does batch tagging Zotero items from Logseq require manual checks for new literature?

Batch tagging Zotero items from Logseq does not require manual checks for new literature. The automation process batch-checks Logseq pages to identify and tag only new Zotero items that lack the in_logseq tag, reducing manual effort.

Why should I use an idempotent operation to sync Logseq to Zotero?

You should use an idempotent operation to sync Logseq to Zotero because it safely allows re-running the sync process without duplicating tags. This ensures your Zotero items remain organized even if the script is executed multiple times.

Do I need the Logseq CLI to extract Zotero URLs from my graph?

Yes, you need the Logseq CLI to extract Zotero URLs from your graph. The sync process uses the Logseq CLI for data extraction, pulling page content to identify referenced Zotero item keys before updating Zotero.