# Graphiti

> Knowledge graph operations via Graphiti API. Search facts, add episodes, and extract entities/relationships.

- Skill: `majiayu000/graphiti` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/graphiti`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/graphiti/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/graphiti

---


# Graphiti Knowledge Graph

Query and manage your knowledge graph using the Graphiti MCP server (rawr-ai fork).

## Prerequisites

- Neo4j database (running via docker-compose)
- Graphiti MCP server (http://localhost:8000/sse)

## Status

✅ Neo4j running on localhost:7474 (bolt://localhost:7687)
✅ Graphiti MCP server running on localhost:8000/sse
✅ Added to .mcp.json for OpenClaw integration

## Tools

### graphiti_search
Search the knowledge graph for relevant facts.

**Usage:**
```bash
bash command:"
GRAPHITI_URL=\$({baseDir}/references/env-check.sh)
curl -s -X POST \"\$GRAPHITI_URL/facts/search\" \
  -H 'Content-Type: application/json' \
  -d '{\"query\": \"YOUR_QUERY\", \"max_facts\": 10}' | jq .
"
```

### graphiti_add
Add a new episode/memory to the knowledge graph.

**Usage:**
```bash
bash command:"
GRAPHITI_URL=\$({baseDir}/references/env-check.sh)
curl -s -X POST \"\$GRAPHITI_URL/messages\" \
  -H 'Content-Type: application/json' \
  -d '{\"name\": \"EPISODE_NAME\", \"content\": \"EPISODE_CONTENT\"}' | jq .
"
```

## Dynamic Configuration

The skill uses environment discovery to find Graphiti automatically:

1. **Clawdbot config**: `clawdbot config get skills.graphiti.baseUrl`
2. **Environment variable**: `$GRAPHITI_URL`
3. **Default fallback**: `http://localhost:8001`

To change the Graphiti URL:
```bash
export GRAPHITI_URL="http://10.0.0.10:8001"
# OR
clawdbot config set skills.graphiti.baseUrl "http://10.0.0.10:8001"
```

## Examples

Search for information:
```bash
bash command:"
GRAPHITI_URL=\$({baseDir}/references/env-check.sh)
curl -s -X POST \"\$GRAPHITI_URL/facts/search\" \
  -H 'Content-Type: application/json' \
  -d '{\"query\": \"Tell me about Essam Masoudy\", \"max_facts\": 5}'
"
```

Add a memory:
```bash
bash command:"
GRAPHITI_URL=\$({baseDir}/references/env-check.sh)
curl -s -X POST \"\$GRAPHITI_URL/messages\" \
  -H 'Content-Type: application/json' \
  -d '{\"name\": \"Project Update\", \"content\": \"Completed Phase 1 of Clawdbot integration\"}'
"
```