Daruka MCP Server

Connect Claude directly to your Daruka project memory. Once installed, just tell Claude to save, search, or load your project context.

---

What it does

Claude gets four new tools it can call automatically:

Tool	What it does
daruka_list_projects	Shows your Daruka projects so you can pick one
daruka_save_memory	Saves the current conversation + extracts decisions/bugs/TODOs
daruka_get_context	Loads your full Switch Context document into Claude
daruka_search_memories	Searches past memories by topic or keyword
daruka_get_memories	Lists your recent memory timeline

---

Setup (5 minutes)

Step 1 — Get your Daruka token

1. Go to daruka.vercel.app/settings
2. Scroll to Chrome extension token
3. Click Generate token
4. Copy the token (starts with ctxos_)

Step 2 — Create the MCP server folder

mkdir daruka-mcp
cd daruka-mcp

Copy these files into it:

• daruka-mcp-server.ts
• package.json
• tsconfig.json

Then install and build:

npm install
npm run build

Step 3 — Add to Claude Desktop

Open your Claude Desktop config file:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this (replace the path and token):

{
  "mcpServers": {
    "daruka": {
      "command": "node",
      "args": ["/absolute/path/to/daruka-mcp/build/daruka-mcp-server.js"],
      "env": {
        "DARUKA_TOKEN": "ctxos_your_token_here",
        "DARUKA_API_URL": "https://daruka.vercel.app"
      }
    }
  }
}

Important: Use the full absolute path — not ./ or ~/.

• Mac example: /Users/yourname/daruka-mcp/build/daruka-mcp-server.js
• Windows example: C:\\Users\\yourname\\daruka-mcp\\build\\daruka-mcp-server.js

Step 4 — Restart Claude Desktop

Quit and reopen Claude Desktop. You should see a tools icon (🔧) in the chat interface.

---

How to use it

Just talk to Claude naturally:

"Save this conversation to my OutPitch project in Daruka"

"Load my ContextOS project context from Daruka"

"What did Daruka save about the Stripe webhook fix?"

"Show me my recent Daruka memories for this project"

"Save everything we discussed to Daruka — project is OutPitch"

Claude will automatically call the right Daruka tool.

---

Example conversation

You: Save this whole conversation to Daruka. Use my ContextOS project.

Claude: I'll save this to Daruka now.

[calls daruka_save_memory automatically]

✓ Saved to Daruka — "Stripe webhook debugging session"

Extracted: 2 decisions, 1 bugfix, 3 TODOs, 2 code patterns

Decisions: Use rawBody for constructEvent; server-side webhooks via Cloud Functions TODOs: Test retry logic with Stripe CLI; handle failed_payment event

View it at: https://daruka.vercel.app/project/your-project-id

---

Add it to Claude.ai (web) — coming soon

Claude.ai's web interface doesn't support MCP yet publicly, but Anthropic has announced MCP connectors for claude.ai. When that launches, Daruka will be submittable as an official connector. The same server code will work.

---

Troubleshooting

"DARUKA_TOKEN environment variable is required" → Make sure the token is in the env block of your claude_desktop_config.json

Claude doesn't show the tools icon → Check the config file is valid JSON (no trailing commas) → Make sure you used the full absolute path → Restart Claude Desktop completely (quit from taskbar/menu bar)

"Daruka API error 401" → Your token has expired or been revoked → Go to daruka.vercel.app/settings and generate a new one

Tools show up but save fails → Make sure you have a Gemini API key set in Daruka Settings → The extraction pipeline needs it to process the conversation