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 who work with Otel and Tinycontext and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-05 · ★ 8 · #107 OF 304 MAINTAINED MEMORY · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Tinycontext

before you install - you'll need

Set OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, 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

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.5.0 · 2026-09-05

TinyContext v0.5.0 adds optional, vendor-neutral OpenTelemetry instrumentation and OTLP export for standalone deployments. · Highlights: · Add optional OpenTelemetry tracing and metrics with standard OTLP environment…

v0.4.1 · 2026-08-25

What changed · Add the list_memories MCP tool for newest-first, filterable, paginated memory previews. · Add the get_memory MCP tool to retrieve a memory by full ID or short reference. · Keep the FastAPI endpoints…

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…

04 · Who maintains Tinycontext

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

05 · Facts

category
memory - ranked #107 of 304 actively-maintained memory servers as of 2026-09-18.
release cadence
9 releases in the last 90 days (latest 2026-09-05)
registry
io.github.TinySuiteHQ/tinycontext (active, first published 2026-07-31 · 9 versions)
packages
oci:docker.io/marcellm01/tinycontext:v0.5.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-09-18, its last commit was 2026-09-05 and it shipped 9 releases in the last 90 days. We re-verify nightly.

How do I install Tinycontext?

Run `uvx tinysuite-context`. The README documents 5 environment variables (OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, TINYCONTEXT_TENANT_SECRET…) to set first. Set OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, 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 · ★ 39,038
  2. Pdf MCP → filesystem companion filesystem · ★ 135

More memory MCP servers · NeuroDock Cognitive Graph · Mnemograph · Toolbelt · Adr Analysis Server · Tribal

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