# ZettelForge MCP server

> Provides agentic memory for cyber threat intelligence by extracting entities, building STIX 2.1 knowledge graphs, and performing intent-aware retrieval.

- Repository: https://github.com/rolandpg/zettelforge
- Page: https://hostedmcp.org/servers/rolandpg/zettelforge
- Transport: stdio
- Stars: 68
- License: MIT
- Latest version: 2.4.0

## Install

### Claude Code

```sh
claude mcp add zettelforge -- uvx zettelforge
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "zettelforge": {
      "command": "uvx",
      "args": [
        "zettelforge"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "zettelforge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zettelforge"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"zettelforge","type":"stdio","command":"uvx","args":["zettelforge"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "zettelforge": {
      "command": "uvx",
      "args": [
        "zettelforge"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add zettelforge -- uvx zettelforge
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.zettelforge]
command = "uvx"
args = ["zettelforge"]
```

### Gemini CLI

```sh
gemini mcp add -s user zettelforge uvx -- zettelforge
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "zettelforge": {
      "command": "uvx",
      "args": [
        "zettelforge"
      ]
    }
  }
}
```

## FAQ

### Does ZettelForge require an internet connection or API keys?

No, it runs entirely in-process with no external API dependency and can run fully offline once models are preloaded.

### How does ZettelForge handle different names for the same threat actor?

It uses alias resolution to ensure different names for the same actor, such as APT28 and Fancy Bear, resolve to the same node.

### What kind of entities can the system extract?

It automatically identifies CVEs, threat actors, IOCs, MITRE ATT&CK techniques, campaigns, tools, and more.
