# jevmem

> jevmem is an open-source MCP server for developer tools. Project rules kept in a JEVMEM.md file in git, with a guard on risky commands. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://avinash-jetwani.github.io/jevmem/
- **Repository:** https://github.com/avinash-jetwani/jevmem
- **MCP Registry name:** io.github.Avinash-jetwani/jevmem
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

Decisions, rules and failed approaches from your chats are saved to a single JEVMEM.md in the repository. Teammates receive the same file through git, and Claude Code, Cursor and Codex all read it. It sits beside Claude Code's own auto memory and adds a shared file, support for other tools and the guard.

The guard works before an action: if a rule says generated migration files must not be hand-edited, Claude Code stops and asks you, quoting the rule, before an edit to one of them runs. The MCP server adds add_memory, search_memory and audit_memory, which call TypeSafe AI's Jev and need a TypeSafe API key.

It runs locally over stdio and one server entry serves one project. It is MIT licensed and listed in Anthropic's Claude plugin directory.

## Features

- **Rules file in git:** One JEVMEM.md carries rules and decisions to every teammate.
- **Command guard:** Checks Claude's actions against saved rules and asks before breaking one.
- **Cross-tool reading:** Claude Code, Cursor and Codex read the same file.
- **Memory search and audit:** Tools for saving, searching and auditing project memory.
- **Answer cache:** A local cache in .jevmem/ can be turned off with JEVMEM_CACHE=0.

## Good for

- Stop agents from editing generated files
- Share team decisions across several coding agents
- Record failed approaches so they are not retried
- Audit saved project rules for conflicts

## Install

### Claude Code (Terminal)

```sh
claude mcp add jevmem --env TYPESAFE_API_KEY='<TYPESAFE_API_KEY>' -- npx -y jevmem
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "jevmem": {
      "command": "npx",
      "args": [
        "-y",
        "jevmem"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "jevmem": {
      "command": "npx",
      "args": [
        "-y",
        "jevmem"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "jevmem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "jevmem"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "jevmem": {
      "command": "npx",
      "args": [
        "-y",
        "jevmem"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "jevmem": {
      "command": "npx",
      "args": [
        "-y",
        "jevmem"
      ],
      "env": {
        "TYPESAFE_API_KEY": "<TYPESAFE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `add_memory`: Saves a decision, rule or failed approach to project memory.
- `search_memory`: Searches saved project memory.
- `audit_memory`: Audits saved memory against the project.

## FAQ

### Is it open source?

Yes, MIT licensed.

### What does the memory search need?

A TypeSafe API key, set as TYPESAFE_API_KEY or read from .jevmem/.env or ~/.jevmem/env.

### Does it work in Claude Desktop?

Yes over MCP; set JEVMEM_ROOT since Claude Desktop starts servers without a project directory.

### Can one server cover many projects?

No, one server entry serves one project.

### Is jevmem free?

Yes. jevmem is open source, so you can use and self-host it for free.

### How do I add jevmem to Claude Code?

Run this command in your terminal: claude mcp add jevmem --env TYPESAFE_API_KEY='<TYPESAFE_API_KEY>' -- npx -y jevmem

### What are the best alternatives to jevmem?

The closest alternatives to jevmem are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/jevmem
