chatgpt2md

CLI tool that converts ChatGPT export (ZIP or conversations.json) into organized Markdown files and builds a full-text search index (Tantivy). It also provides an MCP server (stdio transport) with tools for searching and retrieving conversations for Claude Desktop/Claude Code.

Evaluated Mar 30, 2026 (21d ago)

Repo ↗ Ai Ml cli markdown search tantivy mcp claude chatgpt-export local-first rust

⚙ Agent Friendliness

/ 100

Can an agent use this?

🔒 Security

/ 100

Is it safe for agents?

⚡ Reliability

/ 100

Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality

Documentation

Error Messages

Auth Simplicity

100

Rate Limits

🔒 Security

TLS Enforcement

100

Auth Strength

Scope Granularity

Dep. Hygiene

Secret Handling

Local-first design implies no network exposure; TLS is not applicable to stdio MCP but HTTPS is not part of the threat model. No authentication/scoping described for MCP tools (relies on local process permissions). Secret handling is not discussed; since it processes user exports locally, minimize logging of conversation contents. Dependency/security posture is not verifiable from README alone.

⚡ Reliability

Uptime/SLA

Version Stability

Breaking Changes

Error Recovery

Best When

You have a local ChatGPT data export and want local indexing + Claude integration via MCP without building/hosting your own search service.

Avoid When

You need a centralized hosted service, or you require strong guarantees about dependency security/release stability beyond what is documented in the README.

Use Cases

• Convert personal ChatGPT history exports into Markdown vaults (e.g., Obsidian).
• Search across a large ChatGPT export for specific topics/keywords.
• Let Claude query and read local conversation history via MCP tools.
• Create a year/month organized archive with message metadata in YAML frontmatter.

Not For

• Serving shared/multi-tenant chat histories over a network to other users.
• Use as a hosted SaaS or API (it appears to be local CLI).
• Strict compliance use-cases that require documented security, audit logs, and data isolation guarantees from a server product.

Interface

REST API

GraphQL

gRPC

MCP Server

Yes

SDK

Webhooks

Authentication

Methods: None (local CLI/MCP over stdio)

OAuth: No Scopes: No

No user authentication described; MCP server is local (stdio) and relies on local filesystem paths supplied to the server.

Pricing

Free tier: No

Requires CC: No

No pricing information provided; appears to be a local open-source CLI (MIT license per README).

Agent Metadata

Pagination

none

Idempotent

False

Retry Guidance

Not documented

Known Gotchas

⚠ MCP server expects correct absolute paths (manual setup); relative paths may fail depending on Claude Desktop/Code working directory.
⚠ If the index is not built (or built for different chat files), MCP search may return incomplete results.
⚠ Large exports may take time to convert and index; agent should wait for completion before connecting.

Alternatives

Other ChatGPT export to Markdown tools (various community scripts). Run a local search solution over exported text using Tantivy/other indexing libraries. Use Obsidian + manual import/conversion pipelines without MCP integration. Build a simple local web UI/API over the exported JSON and index (custom).

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for chatgpt2md.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

API endpoint ↗ Agent guide ↗ Report inaccuracy

Scores are editorial opinions as of 2026-03-30.