The Import / Export settings page centralizes all content portability features in 📝MythOS and it located under Content in the settings sidebar (Settings > Content > Import/Export).

Import

Import from Obsidian

Import an Obsidian vault into MythOS via the mythos-mcp CLI. The import:

Converts [[wikilinks]] to MythOS @mentions via fuzzy title matching
Uploads embedded images (![[image.png]]) to Cloudflare R2 storage
Preserves YAML frontmatter tags, aliases, and file creation dates
Supports --dry-run to preview before committing
Supports --visibility flag (default: private) and --skip-existing to avoid duplicates
Triggers a knowledge graph rebuild after import to create memo_links

npx mythos-mcp import --obsidian ~/vault --visibility private

Requires an API key from Settings > API and environment variables (MYTHOS_API_KEY, MYTHOS_USERNAME, MYTHOS_API_URL).

Export

Export as Markdown

Download your entire library as markdown files with YAML frontmatter (title, ID, tags, visibility, dates, contentHash). Compatible with Obsidian, Hugo, and other tools that read markdown. Available as:

Web: One-click download from the Settings page (password-protected, gzipped)
CLI: npx mythos-mcp pull with incremental sync via delta_sync and manifest tracking

npx mythos-mcp pull --output ~/mythos-backup

The CLI supports --since for timestamp-based incremental export, --tags for filtered export, and --full to force a complete re-export.

Export as JSON

Full data export including memos, daily entries, contacts, templates, habits, and settings. Password-protected. For compliance and backup purposes.

Technical Details

Settings page: src/app/settings/import-export/page.tsx
Markdown export endpoint: POST /api/settings/export/markdown
CLI entry point: src/mcp/cli.ts (routes pull/import commands vs MCP server mode)
Obsidian parser: src/mcp/lib/obsidian-parser.ts
Wikilink converter: src/mcp/lib/wikilink-converter.ts
Markdown converter: src/lib/export/memo-to-markdown.ts
npm package: mythos-mcp v2.3.0

Contexts

🏷️#mythos-feature