# frugal-memory (pypi · frugal-memory)

Memory for AI assistants in one SQLite file: full-text search, no vectors, no embeddings.

- Trust score: 64/100 (medium)
- Change this week: +15
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- pypi · `frugal-memory`: 64/100 (this document), [markdown](https://verifymcp.io/servers/komakeule57-maker-frugal-memory/frugal-memory.md), [page](https://verifymcp.io/servers/komakeule57-maker-frugal-memory/frugal-memory)

## Channel facts

- Registry: `pypi`
- Package: `frugal-memory`
- Version: `0.3.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 94/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Declares code that runs automatically (build-time code we could not rule out (a Hatch, PDM or setuptools build hook, a dynamic version we could not read statically, shipped VCS metadata or a stray root module)) and that we could not recognise. It may be perfectly ordinary, but we have not established what it does.
  - 1 of 28 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 7 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 62/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1910 tokens (~238/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability check failed: the tool surface changed between 0.1.4 and 0.3.1: 6 tool removals, 0 breaking changes, 6 additions.
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 8 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the frugal-memory MCP server?

frugal-memory runs locally as a PyPI package, launched with uvx frugal-memory. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add komakeule57-maker-frugal-memory -- uvx frugal-memory
```

### Cursor

```json
{
  "mcpServers": {
    "komakeule57-maker-frugal-memory": {
      "command": "uvx",
      "args": [
        "frugal-memory"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "komakeule57-maker-frugal-memory": {
      "command": "uvx",
      "args": [
        "frugal-memory"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add komakeule57-maker-frugal-memory -- uvx frugal-memory
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "komakeule57-maker-frugal-memory": {
      "type": "local",
      "command": [
        "uvx",
        "frugal-memory"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add komakeule57-maker-frugal-memory --command uvx --arg frugal-memory
```

### Hermes

```yaml
mcp_servers:
  komakeule57-maker-frugal-memory:
    command: "uvx"
    args: ["frugal-memory"]
```

### Netclaw

```json
{
  "McpServers": {
    "komakeule57-maker-frugal-memory": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "frugal-memory"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add komakeule57-maker-frugal-memory -t stdio -c uvx -a frugal-memory
```

### Other

```json
{
  "mcpServers": {
    "komakeule57-maker-frugal-memory": {
      "command": "uvx",
      "args": [
        "frugal-memory"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-30 (score 64, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-29 (score 49, 0)

- [functional] Schema quality: good → excellent
- [functional] Package version: 0.3.0 → 0.3.1

### 2026-10-28 (score 49, −3)

- [security regression] Stability: 0.27 → fail
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Schema quality: 287 → 222
- [functional] Package version: 0.2.3 → 0.3.0

### 2026-10-27 (score 52, 0)

- [security improvement] Malware scan: unverified → pass
- [functional] Package version: 0.2.0 → 0.2.3
- [functional] Package version: 0.2.0 → 0.2.2
- [functional] Package version: 0.2.0 → 0.2.1

### 2026-10-26 (score 52, −14)

- [security regression] Malware scan: pass → unverified
- [functional] Package version: 0.1.5 → 0.2.0

### 2026-10-24 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-23 (score 65, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-22 (score 50, −16)

- [security regression] Malware scan: pass → unverified
- [security regression] Install scripts: pass → partial
- [security] The code this package runs automatically changed: its declared build backend → build-time code we could not rule out (a Hatch, PDM or setuptools build hook, a dynamic version we could not read statically, shipped VCS metadata or a stray root module)
- [functional improvement] Stability: unverified → 0.10
- [functional] Package version: 0.1.4 → 0.1.5

## MCP tools (8)

### `remember` (~274 tokens)

Stores one fact permanently in memory.

Use it for knowledge a later session needs: a decision with its reason, a
pitfall, a measured number, an interface. Not for secrets, guesses or
short-lived details. Search with recall first; if an entry covers the fact,
supersede that one.

Returns the new id, existing entries that resemble it (candidates to
supersede) and a note when the tag is new - often a misspelling.

Args:
    text: The fact. A text that belongs to two kinds is two entries.
    tags: The project, i.e. WHERE the knowledge belongs (spaces or commas
        between several).
    kind: WHICH KIND of knowledge: interface (signature, file name,
        command, data format), pitfall (the obvious approach is wrong
        because ...), decision (with rationale), measurement (a number plus
        its criterion), workflow (how to work with this user), history
        (chronicle, hidden from recall's default view). Empty = unsorted.
    supersedes: Ids this entry replaces, e.g. "12,34". Hidden, not deleted.

Input parameters:

- `kind` (string)
- `supersedes` (string)
- `tags` (string)
- `text` (string, required)

Output parameters:

- `result` (string)

### `recall` (~367 tokens)

Searches memory by words, best matches first.

Use it first, before searching files or the web for something noted before.
It matches words, not meaning: inflected forms count ("configured" ->
"configuring"), synonyms don't - if nothing fits, retry in the other
language your notes may use. No search terms? Browse with topics.

Returns a preview per hit (id, kind, date, title line). Read the ones you
need with show("376,481"), or set full=True for a narrow question.

Args:
    query: Search term(s), FTS5 syntax allowed (e.g. "sqlite AND fts5", "proj*").
    limit: Maximum number of hits (default 8).
    kind: Restrict to kinds of knowledge, e.g. "pitfall,decision".
        Possible: interface, pitfall, decision, measurement, workflow,
        history, unsorted, all. Default: everything except history -
        otherwise the chronicle drowns out every search for a detail.
    tag: Restrict to a project, e.g. "spaceship". Several tags separated
        by comma or space are OR-combined. Sub-tags are included:
        "lighthouse" also matches "lighthouse-project", but
        "mcp-memory-server" does not match "mcp-memory". topics() lists
        which tags exist.
    full: Full text instead of preview (default: no), capped like show.
    include_superseded: Also show superseded entries (default: no).

Input parameters:

- `full` (boolean)
- `include_superseded` (boolean)
- `kind` (string)
- `limit` (integer)
- `query` (string, required)
- `tag` (string)

Output parameters:

- `result` (string)

### `show` (~150 tokens)

Returns the named entries in full text.

Use it after recall or topics, once you know which entries you need - it
takes ids, not search terms. Superseded entries are included: whoever asks
for the id means that one.

Returns about 6000 characters per call, in the order asked. Whatever doesn't
fit comes back as a title line plus the call that fetches it; unknown ids
are named as such.

Args:
    ids: One or more entry ids, e.g. "376,481". Most wanted first.
    full: Everything asked for at once, without the cap (default: no).

Input parameters:

- `full` (boolean)
- `ids` (string, required)

Output parameters:

- `result` (string)

### `topics` (~203 tokens)

Browses memory: the board of all tags, or the title index of one project.

Use it when search terms are missing - a project picked up after months,
or "what happened here lately". To find a specific fact, recall is faster.

Returns the tag board (entries per tag and kind) or, with a tag, that
project's title lines, newest first, one page at a time. Follow up with
show("...") or recall(query, tag="...").

Args:
    tag: Project, e.g. "spaceship". Empty = tag board.
    limit: Rows per page (default 40 for the board, 30 for the title index).
    page: Page of the title index (default 1 = the newest).
    all: Whole title index at once, grouped by kind.

Input parameters:

- `all` (boolean)
- `limit` (integer)
- `page` (integer)
- `tag` (string)

Output parameters:

- `result` (string)

### `consolidate` (~261 tokens)

Finds groups of entries that say largely the same thing.

Use it for tidying up. Read-only, changes nothing: merging is a judgment
call - replace a group by one new entry via remember(..., supersedes="...").
Compares shared word stems weighted by rarity, not meaning; identical
copies are always found. A few seconds for thousands of entries.

Returns how many entries and pairs were compared, then the groups, largest
first, each with its best similarity and its entries (id, kind, date,
title) - or that nothing reached the threshold.

Args:
    tag: Only consider entries from this project (empty = all). Sub-tags
        are included, as in recall.
    kind: Only consider entries of this kind/these kinds, comma-separated.
        Default "all"; "history" alone is the most rewarding case.
    threshold: Share of the weighted stems two entries must have in
        common, 0 to 1. Default 0.5; 0.8 shows only near-copies.
    groups: Maximum number of groups reported (default 5).

Input parameters:

- `groups` (integer)
- `kind` (string)
- `tag` (string)
- `threshold` (number)

Output parameters:

- `result` (string)

### `check` (~220 tokens)

Has a small language model judge how the named entries relate.

Use it on a group from consolidate, or on two entries that seem to disagree,
to ask whether a CONTRADICTION is behind it, PROGRESS (a newer state), or
nothing (INDEPENDENT). Not authoritative: measured 67 % correct on 70 German
pairs, so the result says where to look, not what is true.

Returns one line per pair. Each pair is asked in both directions; only what
comes back the same both times is reported, otherwise "disputed". At most
5 pairs per call, roughly 10 seconds each.

Opt-in: needs MEMORY_FC_URL and MEMORY_FC_MODEL (any OpenAI-compatible
endpoint; MEMORY_FC_KEY if it wants a key). Without them this tool
does nothing and says so. When set up, up to 200 characters of each note
are sent there.

Args:
    ids: Two or more entry ids, e.g. "249,255".

Input parameters:

- `ids` (string, required)

Output parameters:

- `result` (string)

### `forget` (~136 tokens)

Hides entries that are wrong or obsolete and have no replacement.

If a newer entry replaces them, use remember(..., supersedes=...) instead.
Nothing is deleted: show and recall(..., include_superseded=True) still
find them, undo=True brings them back.

Returns the ids changed and names unknown ones.

Args:
    ids: One or more entry ids, e.g. "12,34".
    reason: Why - shown later next to the superseded entry.
    undo: True brings superseded entries back.

Input parameters:

- `ids` (string, required)
- `reason` (string)
- `undo` (boolean)

Output parameters:

- `result` (string)

### `classify` (~167 tokens)

Sets the kind of knowledge for existing entries.

Use it in passing on entries recall shows as "unsorted"; the backlog need
not be sorted in one sitting. Writes only the kind - text, tags, ids and
superseded status stay as they are - and is undone by classifying again.

Returns the ids changed, names unknown ids, and how many live entries are
still unsorted.

Args:
    ids: One or more entry ids, e.g. "376,481"; a range "376-380" means
        every id in between.
    kind: Exactly one of: interface, pitfall, decision, measurement,
        workflow, history. "unsorted" undoes the classification.

Input parameters:

- `ids` (string, required)
- `kind` (string, required)

Output parameters:

- `result` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/komakeule57-maker-frugal-memory/frugal-memory#diagnostics

## Score history

- 2026-11-05: 64
- 2026-11-04: 64
- 2026-11-03: 64
- 2026-11-02: 64
- 2026-11-01: 64
- 2026-10-31: 64
- 2026-10-30: 64
- 2026-10-29: 49
- 2026-10-28: 49
- 2026-10-27: 52
- 2026-10-26: 52
- 2026-10-25: 66
- 2026-10-24: 66
- 2026-10-23: 65
- 2026-10-22: 50
- 2026-10-21: 66
- 2026-10-20: 66
- 2026-10-19: 51

## Common questions

### What is the frugal-memory MCP server?

frugal-memory is an MCP server listed in the public MCP registry as io.github.komakeule57-maker/frugal-memory. Memory for AI assistants in one SQLite file: full-text search, no vectors, no embeddings. This page covers its PyPI package (frugal-memory).

### Is the frugal-memory MCP server safe to use?

frugal-memory scores 64 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the frugal-memory MCP server expose?

frugal-memory exposes 8 tools: remember, recall, show, topics, consolidate, and 3 more. Their descriptions and schemas cost roughly 1,778 tokens of context every time the server is loaded.

### Is the frugal-memory MCP server still maintained?

frugal-memory is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the frugal-memory MCP server under?

frugal-memory declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/frugal-memory/
- Socket report: https://socket.dev/pypi/package/frugal-memory
- Repository: https://github.com/komakeule57-maker/frugal-memory
- Changelog RSS feed: https://verifymcp.io/servers/komakeule57-maker-frugal-memory/frugal-memory.xml
- Changelog JSON feed: https://verifymcp.io/servers/komakeule57-maker-frugal-memory/frugal-memory.json
- HTML version of this page: https://verifymcp.io/servers/komakeule57-maker-frugal-memory/frugal-memory