Tinycontext MCP Server

Context that fits your local LLMs. TinyContext is a token-light local memory layer for AI agents. It stores concise memories and their embeddings in SQLite, ranks them with hybrid BM25 and dense retrieval, and returns only the context that fits the requested token budget.

People connecting memory tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-20 · ★ 8 · #64 OF 259 MAINTAINED MEMORY · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Tinycontext

before you install - you'll need

Set TINYCONTEXT_TENANT_SECRET, TINYCONTEXT_TRUSTED_PROXY_CIDRS, TINYCONTEXT_MEMORY_DB_PATH before connecting.

Claude Code

claude mcp add tinysuitehq-tinycontext -- uvx tinysuite-context

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "tinysuitehq-tinycontext": {
      "command": "uvx",
      "args": [
        "tinysuite-context"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

repo age created 2026-06-30 - young repo, little track record yet

license MIT - declared in the repository

pypi package tinysuite-context - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.TinySuiteHQ is GitHub-verified and matches the repo owner

03 · What Tinycontext can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.4.0 · 2026-08-16

What’s new · Add profile memories with global access across sessions and a dedicated profile token budget. · Add newest-first recent recall when no query is supplied, with bounded token-aware results. · Add memory…

v0.3.1 · 2026-08-15

What’s new · Expose stable 12-character memory refs from save and recall, so delete_memory no longer requires copying a full UUID. · Accept either a short ref or full id for deletion, with explicit handling for…

v0.3.0 · 2026-08-15

What’s new · Add delete_memory(memory_id) across the Python API, MCP server, and FastAPI server, including clear not-found handling. · Document the new deletion workflow. · Stop tracking uv.lock; it is now ignored.

04 · Who maintains Tinycontext

tinycontext is maintained by tinysuitehq. We track 2 MCP servers from tinysuitehq - 2 actively maintained, 222 combined GitHub stars, oldest repo from May 2026.

05 · Facts

category
memory - ranked #64 of 259 actively-maintained memory servers as of 2026-08-25.
release cadence
7 releases in the last 90 days (latest 2026-08-16)
registry
io.github.TinySuiteHQ/tinycontext (active, first published 2026-07-31 · 7 versions)
packages
oci:docker.io/marcellm01/tinycontext:v0.4.0 · pypi:tinysuite-context

06 · Tinycontext FAQ

What is Tinycontext?

Context that fits your local LLMs. TinyContext is a token-light local memory layer for AI agents. It stores concise memories and their embeddings in SQLite, ranks them with hybrid BM25 and dense retrieval, and returns only the context that fits the requested token budget.

Is Tinycontext still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-20 and it shipped 7 releases in the last 90 days. We re-verify nightly.

How do I install Tinycontext?

Run `uvx tinysuite-context`. The README documents 3 environment variables (TINYCONTEXT_TENANT_SECRET, TINYCONTEXT_TRUSTED_PROXY_CIDRS, TINYCONTEXT_MEMORY_DB_PATH) to set first. Set TINYCONTEXT_TENANT_SECRET, TINYCONTEXT_TRUSTED_PROXY_CIDRS, TINYCONTEXT_MEMORY_DB_PATH before connecting. You can also paste the ready-made client config above.

Does Tinycontext run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Tinycontext

Pairs well with

Servers that cover what Tinycontext doesn't - only shown when the pairing reason fits the companion.

  1. Server Filesystem → filesystem companion filesystem · ★ 38,704
  2. X402 List MCP → filesystem companion filesystem · ★ 58

More memory MCP servers · NeuroDock Cognitive Graph · Mnemograph · Toolbelt · Tribal · Mindpm

More Python MCP servers · Lacuna Research MCP · Tendem MCP server · Cn Commerce · Tilde · see all