Hermes Claude Import

A standalone Hermes Agent skill for importing a Claude.ai data export into the configured Hermes memory provider.

Install

git clone https://github.com/magnus919/hermes-claude-import.git \
  ~/.hermes/skills/claude-import

Start a new Hermes session, then ask it to import the directory from Claude's Settings → Privacy → Export data.

What it does

• Streams conversations.json, including exports larger than memory.
• Extracts each conversation's summary and first substantive exchange.
• Imports memories.json project and conversation memories when present.
• Preserves Claude UUID, source type, and timestamps in each dispatched memory block.

The parser is stdlib-only and can be run independently:

python3 scripts/claude_parse.py /path/to/claude-export --output /tmp/claude-memory-units.json

The skill imports through Hermes's memory tool, so storage remains the responsibility of the configured memory provider. It refuses the builtin filesystem provider because a complete export can exceed its safe capacity.

Development

python3 -m pip install -e '.[dev]'
python3 -m pytest -q

See CONTRIBUTING.md for community changes and AGENTS.md for agent-specific repository guidance.

License

MIT. This repository extracts and adapts code and documentation originally submitted to NousResearch/hermes-agent in PR #53786. See LICENSE.