[GUI Plugin] ShelfBridge - Export your library to Goodreads/StoryGraph, Google Sheets

kaylaehman · 06-17-2026, 10:27 PM

ShelfBridge exports your Calibre library to reading-tracker and productivity services.

Supported services

Goodreads / StoryGraph — a CSV in the Goodreads import schema (StoryGraph accepts the same file). No account setup needed.
Google Sheets — writes your catalog into a Sheet you own. Re-exports are idempotent (the sheet is cleared and rewritten), so scheduled runs never pile up duplicates.
OneDrive — uploads the CSV via Microsoft Graph (device-code sign-in).

Features

CSV written UTF-8 with BOM so it opens cleanly in Excel.
Credentials stored in your OS keychain (Windows Credential Manager / macOS Keychain / libsecret), with a clearly-logged plaintext fallback.
Automatic retry/backoff that honours rate-limit Retry-After headers.
Automation: export on library change or on a schedule (15 min through daily).
Read-only with respect to your Calibre library.

Installation
Download the attached shelf_bridge.zip, then in Calibre: Preferences -> Plugins -> Load plugin from file. Restart when prompted. A ShelfBridge button appears on the toolbar.

Setup
Goodreads/StoryGraph need only an output folder. OneDrive and Google Sheets each need a free, one-time OAuth app — step-by-step instructions are in the README:
https://github.com/kaylaehman/ShelfBridge

Source and releases: https://github.com/kaylaehman/ShelfBridge/releases
Licensed GPL-3.0.

Requirements: Calibre 6.0+ (PyQt5 on 6.x, PyQt6 on 7.x — both supported).

Version history

0.1.0 — initial release: Goodreads/StoryGraph CSV, Google Sheets, OneDrive; automation; keychain credential storage.

Comfy.n · 06-17-2026, 10:56 PM

Sounds like a hot idea but where is config?

Rellwood · 06-18-2026, 04:49 PM

Is there ANY CHANCE of fixing it to send up multiple read dates?

kaylaehman · Today, 12:13 AM

Update — v0.1.1 is out (attached below, and on GitHub).

@Comfy.n — good catch, and a fair hit: v0.1.0 actually shipped with no working way to open the settings. Fixed in v0.1.1. You can now configure it two ways: Preferences -> Plugins -> ShelfBridge -> Customize plugin, or the toolbar button's Configure Services... menu.

@Rellwood — not yet, but noted. Today each book exports a single Date Read (the most recent). Goodreads' own importer only accepts one date per book anyway, but for the Google Sheets / OneDrive exports I can add an option to emit all read dates — I'll look at it for a future build.

Also new in v0.1.1

Configurable columns (Google Sheets & OneDrive) — choose which fields become columns, reorder them, and rename the headers, like Calibre's catalog export. Goodreads/StoryGraph keep their fixed import schema.
Export scope — export your entire library or a single virtual library.
Credentials now load correctly from the OS keychain when installed as a zip; faster custom-column reads on large libraries.

Grab shelf_bridge.zip below, or from GitHub: https://github.com/kaylaehman/ShelfBridge/releases

Thanks for the early feedback!

kaylaehman · Today, 01:42 AM

Quote:

Originally Posted by Rellwood

Is there ANY CHANCE of fixing it to send up multiple read dates?

Filed it so you can follow/track it: https://github.com/kaylaehman/ShelfBridge/issues/1

I've also enabled GitHub Issues for ShelfBridge, so feature requests and bug reports can go there: https://github.com/kaylaehman/ShelfB...ues/new/choose — questions and general chat are still welcome here.

Rellwood · Today, 01:50 AM

I don't know how it could be done at this point. Although I have all my start, finish dates in Goodreads appended to their library export via a program I tweaked, I still have no idea how to get them into a format that can be imported. I have so many re-reads that it's prevented me from really updating my Library Thing, HardCover or Story Graph account. It also doesn't help that the books being imported are lacking because the data is missing from ASINs. I have exclusively amazon books and they are all linked and synced with my Calibre and Kindles. This is why I am having trouble moving.

kaylaehman · Today, 01:54 AM

Bug reports & feature requests -> GitHub Issues

Found a bug or have an idea? Please file it on GitHub so it's tracked and doesn't get lost:
https://github.com/kaylaehman/ShelfB...ues/new/choose

Setup help, usage questions, and general discussion are very welcome right here in this thread.

Comfy.n · Today, 02:02 AM

Hmm, I think users are more used to see the plugin toolbar button caption match the plugin name: action_spec = ('Export Catalog'.

But that's fine, I think I made this choice on some plugins. Config is now fine, too.

If you want to publish it in the Index, let me know! More info here: Index of plugins.

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
[GUI Plugin] Goodreads Sync	kiwidude	Plugins	1808	06-18-2026 04:55 PM
[GUI Plugin] Goodreads Characters and Settings	VapidRapidReader	Plugins	9	06-10-2026 07:49 PM
[GUI Plugin] Goodreads Awards	dunhill	Plugins	1	03-04-2026 03:16 PM
The StoryGraph challenge GoodReads with quality recommendations, unfocus on ratings	Marco77	News	45	10-20-2020 02:45 AM
GUI Plugin help for Custom Export Script	iomari	Plugins	4	10-28-2011 09:09 AM

06-17-2026, 10:56 PM	#2
Comfy.n want to learn what I want Posts: 2,274 Karma: 7968921 Join Date: Sep 2020 Device: Libra Colour	Sounds like a hot idea but where is config?

06-18-2026, 04:49 PM	#3
Rellwood Library Breeder (She/Her) Posts: 1,332 Karma: 1937893 Join Date: Apr 2015 Location: Fullerton, California Device: Paperwhite 2015 (2), PW 2024 (12 GEN), PW 2023 (11 GEN), Scribe (1st)	Is there ANY CHANCE of fixing it to send up multiple read dates?

Today, 01:50 AM	#6
Rellwood Library Breeder (She/Her) Posts: 1,332 Karma: 1937893 Join Date: Apr 2015 Location: Fullerton, California Device: Paperwhite 2015 (2), PW 2024 (12 GEN), PW 2023 (11 GEN), Scribe (1st)	I don't know how it could be done at this point. Although I have all my start, finish dates in Goodreads appended to their library export via a program I tweaked, I still have no idea how to get them into a format that can be imported. I have so many re-reads that it's prevented me from really updating my Library Thing, HardCover or Story Graph account. It also doesn't help that the books being imported are lacking because the data is missing from ASINs. I have exclusively amazon books and they are all linked and synced with my Calibre and Kindles. This is why I am having trouble moving.

Today, 01:54 AM	#7
kaylaehman Junior Member Posts: 4 Karma: 10 Join Date: Jun 2026 Device: Kindle Paperwhite	Bug reports & feature requests -> GitHub Issues Found a bug or have an idea? Please file it on GitHub so it's tracked and doesn't get lost: https://github.com/kaylaehman/ShelfB...ues/new/choose Setup help, usage questions, and general discussion are very welcome right here in this thread.

Today, 02:02 AM	#8
Comfy.n want to learn what I want Posts: 2,274 Karma: 7968921 Join Date: Sep 2020 Device: Libra Colour	Hmm, I think users are more used to see the plugin toolbar button caption match the plugin name: action_spec = ('Export Catalog'. But that's fine, I think I made this choice on some plugins. Config is now fine, too. If you want to publish it in the Index, let me know! More info here: Index of plugins.