Transfer & Sync
Your Notes Everywhere

noteshift transfer --from my-notion --to my-memos

# Filter by tags
noteshift transfer --from my-notion --to my-memos --tags work,important

# Only notes updated after a date
noteshift transfer --from my-notion --to my-memos --updated-after 2026-01-01

# Limit number of notes
noteshift transfer --from my-notion --to my-memos --limit 50

# Include archived notes (excluded by default)
noteshift transfer --from my-notion --to my-memos --include-archived

noteshift transfer --from my-notion --to my-memos --dry-run

noteshift transfer --from my-notion --to my-memos --conflict overwrite

noteshift backup --from my-notion --output ./backup --format markdown

noteshift backup --from my-memos --output ./backup.json --format json

noteshift backup --from my-notion --output ./backup --dry-run

# Restore from directory
noteshift restore --to my-memos --input ./backup

# With conflict strategy
noteshift restore --to my-memos --input ./backup --conflict skip

# Dry run first
noteshift restore --to my-memos --input ./backup --dry-run

---
id: abc123
title: My Note
tags: [work, project]
pinned: false
archived: false
createdAt: 2026-01-15T09:00:00Z
updatedAt: 2026-01-20T14:30:00Z
source: notion
---

# My Note

Note content here...

{
  "adapters": {
    "my-notion": {
      "platform": "notion",
      "token": "secret_... or ntn_...",
      "parentId": "database-or-page-id"
    }
  }
}

{
  "adapters": {
    "keep-work": {
      "platform": "google-keep",
      "mode": "enterprise",
      "serviceAccountKeyFile": "/path/to/key.json",
      "userId": "user@company.com"
    }
  }
}

{
  "adapters": {
    "keep-personal": {
      "platform": "google-keep",
      "mode": "personal",
      "takeoutDirectory": "/path/to/Takeout/Keep"
    }
  }
}

{
  "adapters": {
    "my-memos": {
      "platform": "memos",
      "baseUrl": "http://localhost:5230",
      "token": "your-api-token"
    }
  }
}

{
  "adapters": {
    "my-affine": {
      "platform": "affine",
      "baseUrl": "http://localhost:3010",
      "token": "your-token",
      "workspaceId": "workspace-id"
    }
  }
}

{
  "adapters": {
    "local-backup": {
      "platform": "local",
      "directory": "/home/user/notes",
      "format": "markdown"
    }
  }
}

# Add a daily backup at 2 AM
noteshift schedule add \
  --cron "0 2 * * *" \
  --task backup \
  --from my-notion \
  --output ./backup

# Start the daemon
noteshift daemon start

┌───── minute  (0-59)
│ ┌─── hour    (0-23)
│ │ ┌─ day     (1-31)
│ │ │ ┌ month  (1-12)
│ │ │ │ ┌ weekday (0-6, Sun=0)
* * * * *

# Linux — outputs a crontab entry
noteshift os-schedule generate --type crontab

# macOS — outputs a launchd .plist file
noteshift os-schedule generate --type launchd

# Windows — outputs an schtasks XML file
noteshift os-schedule generate --type schtasks

npm install noteshift

import { NotionAdapter } from 'noteshift';

const adapter = new NotionAdapter({
  platform: 'notion',
  token: 'secret_...',
  parentId: 'database-or-page-id', // optional
});

const notes = await adapter.listNotes();
await adapter.createNote({ title: 'Hello', content: '# Hello' });

import { MemosAdapter } from 'noteshift';

const adapter = new MemosAdapter({
  platform: 'memos',
  baseUrl: 'http://localhost:5230',
  token: 'your-api-token',
});

const notes = await adapter.listNotes();
await adapter.createNote({ title: 'Hello', content: 'World' });

import { GoogleKeepAdapter } from 'noteshift';

// Enterprise (service account)
const adapter = new GoogleKeepAdapter({
  platform: 'google-keep',
  mode: 'enterprise',
  serviceAccountKeyFile: '/path/to/key.json',
  userId: 'user@company.com',
});

// Personal (read-only Takeout)
const reader = new GoogleKeepAdapter({
  platform: 'google-keep',
  mode: 'personal',
  takeoutDirectory: '/path/to/Takeout/Keep',
});

import { LocalAdapter } from 'noteshift';

const adapter = new LocalAdapter({
  platform: 'local',
  directory: '/home/user/notes',
  format: 'markdown', // or 'json'
});

import { AffineAdapter } from 'noteshift';

const adapter = new AffineAdapter({
  platform: 'affine',
  baseUrl: 'http://localhost:3010',
  token: 'your-token',
  workspaceId: 'workspace-id',
});

import { TransferEngine, NotionAdapter, MemosAdapter } from 'noteshift';

const source = new NotionAdapter({ platform: 'notion', token: '...' });
const dest   = new MemosAdapter({ platform: 'memos', baseUrl: '...', token: '...' });

const engine = new TransferEngine({ conflictStrategy: 'skip' });

const result = await engine.transfer(source, dest, {
  dryRun: false,
  tags: ['work'],
  limit: 100,
});

console.log(`Created: ${result.created}, Updated: ${result.updated}, Skipped: ${result.skipped}`);

interface NoteAdapter {
  connect(): Promise<void>;
  disconnect(): Promise<void>;
  listNotes(filter?: NoteFilter): Promise<Note[]>;
  getNote(id: string): Promise<Note>;
  createNote(note: CreateNoteInput): Promise<Note>;
  updateNote(id: string, note: UpdateNoteInput): Promise<Note>;
  deleteNote(id: string): Promise<void>;
  testConnection(): Promise<boolean>;
}

git clone https://github.com/SkyLostTR/NoteShift.git
cd NoteShift
npm install
npm run build
npm test