Skip to content

Mobile Integrations

Mobile integrations let the Social Archiver mobile app send completed archives to external knowledge and read-it-later tools. These integrations are configured from the mobile app, not from the Obsidian plugin.

Current mobile app integrations include Notion, Reader, and Karakeep.

Overview

IntegrationStatusBest forConnect with
NotionAvailableBuilding a Notion database of archived posts and pagesNotion OAuth from the mobile app
ReaderAvailable when shown in your mobile appSending archives to Readwise ReaderReadwise access token
KarakeepBeta, available when shown in your mobile appSaving archives to a self-hosted bookmark managerKarakeep server URL and API key

Reader means Readwise Reader in the mobile app. If Reader or Karakeep does not appear in your settings, update the mobile app first. Some integrations can also depend on rollout or build availability.

Before You Connect

  1. Install and sign in to the Social Archiver mobile app.
  2. Open Settings -> Integrations.
  3. Keep Auto-sync enabled if you want completed archives to sync to Notion and other connected clients automatically.
  4. Use each integration's Auto-save setting for Reader and Karakeep.
  5. Turn on WiFi only if you want client sync to wait for WiFi.

Each integration uses your Social Archiver account, but the external service still needs its own authorization, token, or API key.

Notion

The Notion integration syncs completed archives from the mobile app to a Notion workspace. Social Archiver can create or reuse a Social Archives database, then write each archive as a Notion page.

What It Sends

  • Archive title, platform, original URL, archive ID, and archived date
  • Available metadata such as author, handle, published date, likes, comments, shares, and views
  • Archive content blocks and available media references
  • Video upgrade processing where supported by the backend and Notion file limits

Connect Notion

  1. Open the mobile app.
  2. Go to Settings -> Integrations.
  3. Tap Connect on the Notion row.
  4. Authorize Social Archiver in the Notion browser flow.
  5. Grant access to the workspace or page where the database can be created.
  6. Return to Social Archiver after authorization completes.

After connection, the Notion row shows the connected workspace. New completed archives can sync automatically when Auto-sync is enabled.

Disconnect Notion

Tap the connected Notion row in Settings -> Integrations, then confirm disconnect. Syncing to that workspace stops, but existing Notion pages are not deleted.

Reader

The Reader integration saves completed archives to Readwise Reader. It is useful when you want Social Archiver captures to enter the same reading queue as articles, newsletters, and saved web pages.

What It Sends

  • Original URL and archive title
  • Author, summary, content or HTML, image URL, and notes when available
  • Tags, including your default tags and optional platform tag
  • Reader category based on the source, such as article, social post, or video

Connect Reader

  1. Open readwise.io/access_token and copy your access token.
  2. Open the Social Archiver mobile app.
  3. Go to Settings -> Integrations.
  4. Tap Connect on the Reader row.
  5. Paste the token and connect.

Reader Settings

Tap the connected Reader row to configure:

  • Auto-save: save to Reader when archives complete
  • Save Location: send items to Later or New
  • Default Tags: tags added to Reader saves
  • Include platform tag: add tags such as the source platform name
  • Platforms: choose which mobile archive sources are allowed to save to Reader

You can also use Save to Readwise from an archive action menu when the archive has an original URL and the platform is allowed.

Disconnecting Reader removes the saved token from the mobile app. Existing Reader items are not deleted.

Karakeep

The Karakeep integration saves completed archives as bookmarks in a Karakeep server. It is useful if you run a self-hosted read-it-later or bookmark workflow.

What It Sends

  • Original URL and archive title
  • Summary or note content when available
  • Default tags and optional platform tag
  • Archive metadata that can be represented in a Karakeep bookmark

Connect Karakeep

  1. In Karakeep, create an API key from Settings -> API Keys.
  2. Open the Social Archiver mobile app.
  3. Go to Settings -> Integrations.
  4. Tap Connect on the Karakeep row.
  5. Enter your Karakeep server address, such as https://bookmarks.example.com.
  6. Paste the API key and connect.

The mobile app accepts a base server URL and normalizes it for the Karakeep API. You do not need to add /api/v1.

Karakeep Settings

Tap the connected Karakeep row to configure:

  • Auto-save: save to Karakeep when archives complete
  • Default Tags: tags added to Karakeep bookmarks
  • Include platform tag: add tags such as the source platform name
  • Platforms: choose which mobile archive sources are allowed to save to Karakeep

You can also use Save to Karakeep from an archive action menu when the archive has an original URL and the platform is allowed.

Disconnecting Karakeep removes the saved credentials from the mobile app. Existing Karakeep bookmarks are not deleted.

Auto-save and Manual Save

Auto-save runs after an archive completes. Manual save actions are available from archive action menus for Reader and Karakeep when:

  • The integration is connected and enabled
  • The archive has an original URL
  • The archive platform is not excluded in that integration's settings
  • The mobile device is online

Reader and Karakeep can report that an item already exists. In that case, the mobile app shows an "Already in Reader" or "Already in Karakeep" message instead of creating a duplicate.

Troubleshooting

ProblemWhat to check
Integration row is missingUpdate the mobile app. Reader and Karakeep may only appear in supported builds or rollout groups.
Notion connect failsConfirm the browser authorization completed and that Social Archiver has access to at least one Notion page where a database can be created.
Reader token failsGenerate a fresh token from readwise.io/access_token, then paste it again.
Karakeep connect failsCheck the server URL, API key, HTTPS access, and whether the Karakeep server is reachable from your phone.
Notion sync did not runConfirm Auto-sync is enabled and the Notion connection is active.
Reader or Karakeep auto-save did not runConfirm that integration's Auto-save setting is enabled, the platform is allowed, the archive has an original URL, and the phone is online.
Sync waits too longCheck whether WiFi-only sync is enabled and whether the phone is currently on WiFi.

Released under the MIT License.