Clarik Mcp Server

io.github.MikerichardmailPublished by GitHub account Mikerichardmailv0.1.1Updated Oct 24, 2026

Clarity and memory persistent workspace context manager for Claude.

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Local MCP server that gives Claude a persistent, project-isolated memory and checkpoint workspace so context survives between sessions.

What you can do
  • Store, list and recall project memories such as stack choices, decisions, file purposes and gotchas, with relevance-ranked injection into context
  • Save and resume session checkpoints covering goal, progress, decisions and next steps
  • Guard protected files and flag unverified assumptions or contradicting memories (Pro tools)
  • Index the codebase, monitor token usage, review diffs and detect hallucinations (Pro tools)
  • Search and export past sessions, and keep reusable prompt templates (Pro tools)
When to use it
Worth adding for developers who use Claude Desktop or Claude Code daily on long-running repositories and want decisions and gotchas to carry over between sessions without re-pasting context. Also useful when sessions run out of context and work needs to be resumed later.
Requirements
Runs as a local npm package (npx clarik) over stdio on macOS, Windows or Linux; the installer writes config for Claude Desktop and Claude Code. A Pro license key is needed for the paid tools, activated through the CLI. Uses the user's own Anthropic API key for model calls.
Before you install
Pro tools cost money: a $20 lifetime or $8/month plan, activated with a license key. Pro license validation contacts Gumroad about once per day, and Pro tools stop after a 5-day offline grace period. The installer modifies Claude Desktop and Claude Code configuration files, and memory is written to a local directory that persists until deleted. Token-savings figures are the vendor's own estimates.

Installation

In SourceWeft

  1. Open Clarik Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

✨ Clarik

Clarity and memory for Claude. One install.

[NPM Version] [License] [Platform]

Claude forgets everything between sessions. Clarik fixes that.

Memory that persists · Context that stays lean · Sessions that never die

Get Started · All 20 Tools · How It Saves You Money · Go Pro

🚀 Quick Start

bash
npx clarik install

That's it. Clarik detects Claude Desktop and Claude Code, configures both, and starts working silently in the background.

╔═══════════════════════════════════════╗║           Welcome to Clarik           ║║   Clarity and memory for Claude.      ║╚═══════════════════════════════════════╝
✅ Detected: Claude Desktop✅ Detected: Claude Code✅ Checking compatibility...✅ Done. Clarik is active.

Open Claude and start chatting. Clarik remembers everything.

💡 What It Does

Clarik is an MCP server that silently fixes the biggest problems developers have with Claude:

ProblemHow Clarik Fixes It
🧠 Claude forgets everything between sessionsPersistent memory — facts, decisions, and gotchas survive forever
📄 Context fills up and quality dropsIntelligent injection — only the most relevant memories are loaded
💸 Repeating context wastes tokensToken optimization — saves $47–73/month on API costs
🔄 Lost progress when context fills upCheckpoints — save and resume exactly where you left off
🗂️ Memories from one project leak into anotherProject isolation — each repo has its own memory space
⚠️ Claude edits files it shouldn'tRepo guard — protected files require your confirmation
🤔 Claude assumes instead of askingAssumption checker — flags unverified claims

🔧 All 20 Tools

Free Tools (no license needed)

ToolWhat It Does
clarik_memory_learnExtract and store facts from conversations. Strips thinking blocks.
clarik_memory_recallRetrieve relevant memories ranked by relevance, recency, and importance.
clarik_memory_listShow all memories for the current project.
clarik_memory_editUpdate a specific memory fact.
clarik_memory_clearClear memories by category or all.
clarik_context_trimIntelligent memory injection within a token budget.
clarik_checkpoint_saveSave a structured snapshot of your session state.
clarik_checkpoint_resumeResume from a checkpoint — pick up exactly where you left off.

Pro Tools ($20 lifetime)

ToolWhat It Does
clarik_project_indexFile-to-purpose map — Claude understands your entire codebase.
clarik_token_monitorLive token usage tracking. Warns at 70% context.
clarik_memory_archiveMove stale memories to archive. Keeps active memory fast.
clarik_conflict_resolverSurface and resolve contradicting memories.
clarik_change_scope_guardProtected file confirmation before edits.
clarik_assumption_checkerFlag when Claude assumes instead of asking.
clarik_diff_reviewerStructured diff review with explanations.
clarik_hallucination_detectorCross-check claims against your actual code.
clarik_decision_timelineTrack architectural decisions with dates and reasons.
clarik_prompt_librarySave and reuse prompt templates.
clarik_session_searchFull-text search across past sessions.
clarik_export_sessionExport session data as JSON or Markdown.

💰 Token Savings

Clarik's intelligent memory injection means Claude processes fewer redundant tokens.

Real Numbers (Sonnet 4.6 at $3/M input tokens)

Without ClarikWith Clarik
Input tokens/session~800K~320K
Cost per session~$3.90~$1.50
Monthly cost (20 days)~$78/mo~$5–31/mo
Monthly savings—$47–73/mo
Clarik Pro costs $20 once.Saves $47–73/month.Pays for itself in 8 days.

🏷️ Pricing

TierPriceWhat You Get
Free$0 forever8 core tools — memory, context, checkpoints
Pro Lifetime$20All 20 tools. One payment. Forever.
Pro Monthly$8/moAll 20 tools. Cancel anytime.

→ Get Clarik Pro

Already have a key?

bash
npx clarik activate YOUR-KEY

🛡️ Safe Modes

Clarik includes four safety modes to match your workflow:

ModeMemoryGuardsBest For
Safe (default)✅ On✅ ActiveNormal development
Strict✅ On🔒 Confirm allProduction code, sensitive repos
Minimal❌ Off❌ OffMaximum privacy, quick tasks
Creative✅ On🟡 RelaxedPrototyping, exploration

🖥️ CLI Commands

bash
npx clarik install          # Install into Claude Desktop + Claude Codenpx clarik activate KEY     # Unlock Pro tools with license keynpx clarik status           # Show plan, tools, savings, grace periodnpx clarik upgrade          # Open clarik.dev/pro in browsernpx clarik uninstall        # Clean removal from all configs

🔒 Privacy & Data

Your data never leaves your machine.

  • All memory stored locally in ~/.clarik/
  • No telemetry, no analytics server, no cloud sync
  • No data transmitted except to Anthropic's API using your own API key
  • You own your memory files — they're plain JSON you can read, edit, or delete
  • License validation is the only network call (Gumroad, once per 24 hours)

❓ FAQ

Does Clarik send my code anywhere?

No. Everything stays on your machine. Clarik stores memories as local JSON files. The only network request is license validation via Gumroad (Pro users, once/day).

Does it work with Claude Desktop and Claude Code?

Yes. The installer detects and configures both automatically.

What happens when my context fills up?

Clarik can save a checkpoint of your current session — goal, progress, decisions, next steps. Start a fresh session and resume instantly with clarik_checkpoint_resume.

Can I use it offline?

Yes. Free tools work offline always. Pro tools have a 5-day offline grace period after your last successful license check.

Does it work on Windows?

Yes. Full Windows support with automatic cmd /c wrapper for stdio compatibility. Also works on macOS and Linux.

Will it conflict with other MCP servers?

No. All tools are prefixed with clarik_ to prevent naming conflicts.

Can I see what Clarik has memorized?

Yes. Use clarik_memory_list to see all stored memories, or browse the JSON files directly in ~/.clarik/projects/.

How do I delete my data?

bash
npx clarik uninstall        # Remove from Claude configsrm -rf ~/.clarik/           # Delete all stored data

🔧 Compatibility

PlatformStatus
macOS✅ Fully supported
Windows✅ Fully supported (cmd /c wrapper)
Linux✅ Fully supported
Claude Desktop✅ Auto-configured
Claude Code✅ Auto-configured

Known Issues

  • macOS beta: MCP connections may be unstable on macOS beta releases. The installer will warn you if a beta version is detected.
  • Transport: Clarik uses stdio transport only. SSE and HTTP transports are not supported due to known MCP compatibility issues.

🔍 Troubleshooting

Clarik tools don't appear in Claude

  1. Make sure the install completed successfully: npx clarik status
  2. Restart Claude Desktop / Claude Code
  3. Check that the MCP config file was written correctly:
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

"Connection lost" or frequent disconnects

Clarik includes a 30-second heartbeat ping to keep the connection alive. If you still experience disconnects:

  1. Update Claude Desktop to the latest version
  2. Avoid macOS beta releases if possible
  3. Check ~/.clarik/ directory permissions

License activation fails

  1. Check your internet connection
  2. Verify the key format: CLARIK-XXXX-XXXX-XXXX
  3. Try again — Gumroad's API occasionally has brief outages
  4. Pro tools work offline for 5 days after last successful check

📊 How Memory Works

What Clarik Learns

  • ✅ Stack and framework choices ("We're using Next.js 14 with App Router")
  • ✅ Architectural decisions ("Moved from REST to tRPC")
  • ✅ File purposes ("lib/auth.ts handles JWT and sessions")
  • ✅ Gotchas and warnings ("Don't use the v2 API — it's broken")
  • ✅ User-confirmed facts

What Clarik Never Learns

  • ❌ Thinking blocks (<thinking>, <antml-thinking>)
  • ❌ Chain-of-thought traces
  • ❌ Speculative guesses
  • ❌ Content before a user correction

Memory Ranking

When recalling memories, Clarik scores each fact:

score = (relevance × 0.5) + (recency × 0.3) + (importance × 0.2)

Only the highest-scoring facts are injected into context — never everything at once.

Project Isolation

Each project gets its own memory space, derived from:

git remote URL → workspace root → package.json name

React project memories never appear in your Python project.

Legal

Clarik is an independent, community-built tool. It is not affiliated with, endorsed by, or associated with Anthropic PBC in any way.

Claude® is a registered trademark of Anthropic PBC. All references to Claude, Claude Desktop, and Claude Code are for compatibility identification purposes only.

Token cost savings are estimates based on typical developer usage patterns. Actual savings depend on your workflow, model choice, and usage volume.

Clarik stores all data locally on your device. No data is transmitted to any server except the Anthropic API using your own API key.

Provided as-is without warranty of any kind.

Full terms: https://clarik.dev/terms

Built for developers who use Claude every day.

Get Started · Go Pro · Report Issues

Source: README.md at commit 9a5c610

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts