ChatCrystal
Local-first AI PKM memory for coding conversations.
Connector by ZengLiangYi · GitHub account verified by the MCP Registry
Chalk Labs
Need help deploying ChatCrystal?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/zengliangyi-chatcrystal
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: agent-memory, knowledge-base
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 6 read · 1 write · 0 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 7
Read from the source code; the running server may list different tools.
Read 6 · Look things up without changing anything.
get_noteget_relationslist_notesrecall_for_tasksearch_knowledgevalidate_task_memory
Write 1 · Create, change, send or run things.
write_task_memory
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
CHATCRYSTAL_API_TOKEN
Other settings (environment variables or headers).
CHATCRYSTAL_BASE_URL
Network hosts it talks to 6
api.anthropic.com· found in codeapi.openai.com· found in codeapi.orcarouter.ai· found in codegenerativelanguage.googleapis.com· found in codegithub.com· found in codezengliangyi.github.io· found in code
Files it touches
~/.claude/projects- Your home directory (~)
~/.codex/sessions
Tools (7)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
get_noteGet the full content of a note including title, summary, key conclusions, code snippets, and tags.
get_relationsGet related notes for a given note, including relationship type and confidence score.
list_notesList note summaries for browsing and narrowing the ChatCrystal knowledge base. Use this when you need paginated notes filtered by tag or title/summary keyword. Use search_knowledge instead for semantic relevance ranking, and get_note when you already have an id and need the full note body. Returns note metadata and summaries, not full note content.
recall_for_taskRetrieve reusable task memories before starting substantive coding work. Use this at the beginning of implementation, debugging, migration, configuration, investigation, refactor, or optimization tasks to load project-scoped memories first and optional global lessons second. Use mode="debug" when the user reports an error, failing command, regression, or incident; include error_signatures and related_files when available. Use search_knowledge instead for ad hoc semantic note search that is not tied to the current task. This tool is read-only and returns ranked memories plus optional related-no…
search_knowledgeSemantic search across your AI conversation knowledge base. Returns matching notes ranked by relevance.
validate_task_memoryDry-run validation for a candidate task memory before calling write_task_memory. Use this after meaningful work and before persisting a lesson to check whether the candidate is durable, specific, reusable, and shaped like a high-quality ChatCrystal note. It has no side effects and never writes to the knowledge base. Returns acceptance, rejection reason, warnings, and materialized note fields so agents can revise the candidate or skip weak work logs.
write_task_memoryPersist a task memory only when it can become a high-quality ChatCrystal note: specific title, concrete summary, meaningful key conclusions, and a durable reusable lesson such as a pitfall, fix, decision, pattern, or symptom-to-resolution mapping. Do not write one-time environment checks, version/status reports, ordinary progress logs, or vague robustness claims. Weak auto writebacks are skipped by core validation and recorded only as receipts.
Signals
- Stars
- 61
- Forks
- 5
- Open issues
- 0
- Contributors
- 2
- Last commit (this folder)
- Oct 23, 2026 (8 days ago)
- Last release
- Oct 23, 2026 (8 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.ZengLiangYi/chatcrystal- Version
- 0.6.2
- Auth
- API key
- Packages
- npm chatcrystal
- License
- Apache-2.0
- Repository
- github.com/ZengLiangYi/ChatCrystal
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from ZengLiangYi
- 0.626score
chatcrystal-debug-recall
ZengLiangYi
Recall ChatCrystal memories for debugging tasks involving failing tests, compiler errors, runtime exceptions, dependency issues, environment breakage, or…
SkillBFreshness: B★ 61Claude Code +9 - 0.626score
chatcrystal-task-recall
ZengLiangYi
Recall project-first and global-supplement ChatCrystal memories before substantive implementation, refactoring, migration, configuration, investigation, or…
SkillBFreshness: B★ 61Claude Code +9 - 0.626score
chatcrystal-task-writeback
ZengLiangYi
Write reusable ChatCrystal task memories after substantive work completes.
SkillBFreshness: B★ 61Claude Code +9
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get ChatCrystal running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
ChatCrystal MCP server. Agent Mart. https://agentmart.dev/connectors/zengliangyi-chatcrystal (last updated 2026-10-24)