gkeep-parser

Convert Google Keep Takeout exports (HTML) into clean JSON data.

A lightweight Node.js library and CLI tool to parse the messy HTML files generated by Google Takeout into structured JSON objects.

📦 Installation

# Install globally for CLI
npm install -g gkeep-parser

# Install as dependency
npm install gkeep-parser

💻 CLI Usage

1. Download your data from Google Takeout (Select "Keep" only).
2. Extract the ZIP file.
3. Run the parser on the folder:

gkeep-parser to-json ./Takeout/Keep -o notes.json

🔧 API Usage

import { parseKeepHtml } from 'gkeep-parser';
import fs from 'fs';

const html = fs.readFileSync('My Note.html', 'utf-8');
const note = parseKeepHtml(html);

console.log(note.title);
console.log(note.tags); 
// Output: ['Personal', 'Ideas']

🧩 Output Format

interface KeepNote {
  title: string;
  content: string; // HTML content
  textContent: string; // Plain text
  tags: string[];
  created: string; // ISO 8601
  isArchived: boolean;
  isPinned: boolean;
  isTrashed: boolean;
  attachments: { filePath: string; mimeType: string; }[];
}

License

MIT

{ github.com/mgks }