Cross-App Notes Bridge

English · 简体中文

An Obsidian plugin that exports notes as portable Markdown and bridges your vault with other note-taking apps — Bear (via x-callback-url), WPS Cloud Note, Youdao Note, Flomo, and Yinxiang (印象笔记) (via their respective CLI/MCP/REST clients).

Mobile-safe: stdio MCP transports and Bear are guarded at runtime and degrade gracefully on iOS/Android.

Why one plugin instead of four?

These integrations share the same pipeline — selection → Markdown transforms → provider dispatch — and most users who care about Markdown portability use more than one of these apps. Bundling avoids duplicating the transform layer and keeps the right-click menu unified. Each provider can be enabled/disabled and trusted independently in settings, so you only see what you configure.

The plugin is intentionally scoped to first-class clients for these apps; there is no generic "add any MCP server" UI yet, because no single integration shape works across arbitrary MCP servers. New providers will be added as first-class clients in future versions.

Features

Export as pure Markdown

Transform Obsidian-specific syntax into portable Markdown that works anywhere:

• Copy as pure Markdown — transform the active note and copy to clipboard.
• Export to folder — write transformed notes to a configurable export directory.

Transform options

Bear (macOS / iOS)

• Send active note to Bear — dispatched via bear://x-callback-url/create. Tags from frontmatter are preserved.
• Import from Bear — enter a note UUID or Bear URL; the plugin opens Bear and writes the returned content into your vault.

WPS Cloud Note (desktop)

Send notes to WPS Cloud Note via the WPS Note CLI or its MCP server endpoint. Configure transport, command path, and headers in settings.

Youdao Note (desktop)

Send notes to Youdao Note via the official youdaonote CLI. The plugin can detect the CLI, push your API key to it, and run a connection test from settings.

Flomo

Export memos to Flomo via its official streamable-HTTP MCP server at https://flomoapp.com/mcp. Requires a Flomo Pro account and a personal API token, configured per provider in settings. Push-only — Flomo's MCP is a write surface today, so importing memos back into the vault isn't supported.

Yinxiang (印象笔记)

Export notes to and import notes from Yinxiang via its REST API at https://app.yinxiang.com. Authenticate with an OAuth token from the Yinxiang skills OAuth page. Supports:

• Export — send notes to a specific notebook or your default notebook
• Import — browse and search your Yinxiang notes, then pull them back into your vault as Markdown
• Notebook selection — choose a default notebook in settings, or the plugin will use your Yinxiang default

Context menu

Right-click any file in the file explorer (or select multiple files) to find the Cross-App Notes Bridge submenu with all available actions.

Settings

Configure via Settings → Community plugins → Cross-App Notes Bridge.

• Export folder — directory for exported notes (default: Exports)
• Import folder — directory for imported notes (default: Imports)
• Concurrency — parallel export workers (default: 4)
• Transform options — configure Markdown output format
• Providers — enable, trust, and configure Bear / WPS / Youdao / Flomo / Yinxiang independently

Commands

Installation

Via BRAT (recommended for beta testing)

The plugin isn't in the official community catalogue yet. The easiest way to install and stay up-to-date is through BRAT (Beta Reviewers Auto-update Tool):

1. Install BRAT from Settings → Community plugins → Browse, then enable it.
2. Open Settings → BRAT → Add Beta plugin and paste huangcheng/cross-app-notes-bridge.
3. BRAT downloads the latest release into your vault and tracks new versions automatically.

See the BRAT plugin docs for details on auto-updates and pinning to a specific version.

From GitHub release

1. Download main.js, manifest.json, and styles.css from the latest release.
2. Copy them into <vault>/.obsidian/plugins/advanced-import-export/.
3. Enable the plugin in Settings → Community plugins.

Build from source

git clone https://github.com/huangcheng/cross-app-notes-bridge.git
cd cross-app-notes-bridge
npm install
npm run build

Copy the output files (main.js, manifest.json, styles.css) into your vault's plugin directory.

Development

npm install        # install dependencies
npm run dev        # watch mode — auto-rebuild on changes
npm run build      # production build
npm run lint       # run ESLint

Privacy

• No telemetry. The plugin does not call any analytics, tracking, or "phone home" endpoint.
• Credentials stay local. API keys and provider configuration are stored in your vault's plugin data file (.obsidian/plugins/advanced-import-export/data.json) and never leave your machine, except for the explicit calls you trigger to the configured provider (e.g. WPS server endpoint, Youdao CLI subprocess, Bear's URL scheme).
• Network calls are scoped to the provider you configure. Disabling or untrusting a provider stops all calls for that provider.
• Outbound URLs: Bear → bear:// URL scheme (local IPC, no network); WPS → the server URL or CLI binary you configure; Youdao → the local youdaonote CLI (calls Youdao's API on your behalf using the API key you provide it); Flomo → https://flomoapp.com/mcp with Authorization: Bearer <your-token>; Yinxiang → https://app.yinxiang.com/third REST API with auth: <your-token>.

License

MIT