# 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

```bash
mkdir daruka-mcp
cd daruka-mcp
```

Copy these files into it:
- `daruka-mcp-server.ts`
- `package.json`
- `tsconfig.json`

Then install and build:

```bash
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):

```json
{
  "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