Log inSubmit server
GEML — a plain Text document format built to be edited in place, one section at a time logo

GEML — a plain Text document format built to be edited in place, one section at a time

Edits Markdown and GEML documents by addressable block, with targeted reads, validated writes, replacements, and revision history.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install GEML — a plain Text document format built to be edited in place, one section at a time

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "geml-a-plain-text-document-format-built-to-be-edited-in-place-on": {
      "command": "npx",
      "args": [
        "-y",
        "@geml/geml"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command installed and started the server, which then stopped for configuration (such as an API key) that our sandbox does not have — expected for servers that connect to your account.

npx -y @geml/geml

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 2d ago.

Overview

  • geml
  • markdown
  • document-editing
  • developer-tools

GEML — a plain-text document format built to be edited in place, one section at a time MCP server works with Markdown and GEML files through addressable document operations. It lets agents list and locate blocks, read or update a single section, replace text, and save revisions without rewriting unrelated content. GEML parses documents into a structured tree and validates writes before they are applied. Reach for it when an agent needs precise, low-context edits to long plain-text documents.

Use cases

  • Read one section of a long Markdown file
  • Update a named block without rewriting the document
  • Replace text while identifying its containing block
  • Save and roll back document revisions
  • Address individual cells or nested data values

Key features

  • Addressable Markdown and GEML blocks
  • Targeted reads and writes
  • Deterministic parsing and validation
  • Text replacement with block reporting
  • Revision history and rollback
  • Nested value coordinates and modular references

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

6/6 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · @geml/geml (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars30Stargazers on the source repository.
npm downloads3.5kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Install checkRunsOur sandbox started it; it then asked for an API key or config.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How GEML — a plain Text document format built to be edited in place, one section at a time works

What GEML — a plain-text document format built to be edited in place, one section at a time MCP server does

GEML provides agent-oriented operations for Markdown and GEML documents. Its central model is an addressable document made of named blocks. Sections, code, tables, diagrams, metadata, and prose can all be represented as blocks, while structured values inside a block can be addressed by coordinates such as array indexes or object keys.

For existing Markdown, the format can be used without conversion. Agents can inspect a file’s sections, retrieve one target, and write that target back while leaving other content untouched. GEML files provide a finer-grained format when section-level addressing is not enough, including access to individual table cells or nested data values.

The GEML — a plain-text document format built to be edited in place, one section at a time MCP server is relevant to workflows where whole-file reads create unnecessary context or where repeated model rewrites risk damaging unrelated text.

How it works

A document is parsed into a typed tree with deterministic block boundaries. Names such as #key-features identify blocks, while coordinates identify values inside structured content. Reads can therefore return only the requested block or value instead of sending the complete file to an agent.

Writes are applied as targeted changes and then checked against the complete document. The material describes these changes as byte-level splices, with untouched bytes preserved. If validation fails, the write is refused rather than committed. This supports partial updates and avoids requiring an agent to reproduce the original document.

GEML also supports references between documents and fragments. A source node can be changed once while references continue to point to it, reducing duplicated content and version drift. .geml documents can be converted to Markdown for delivery with the --to md workflow described in the repository.

Tools and capabilities

The documented command operations include:

  • list, which returns the document’s addressable sections.
  • find, which locates matching content and identifies the containing block.
  • get, which reads one named block or nested value.
  • set, which changes one section or addressed value.
  • replace, which swaps text and reports the block involved.
  • history save, which records a revision beside the source file in a .gemlhistory file.

Revision history can be read back or used to roll back a block or an entire file, according to the repository description. The format also includes profiles for domain-specific vocabulary, with validation and fallback to standard blocks when an environment does not know a profile.

Limitations and notes

It also does not document a separate MCP tool schema beyond the corresponding GEML operations and command examples.

Markdown remains supported for section addressing, but it does not gain GEML’s full structured representation merely by being read. Use .geml when nested values, finer-grained coordinates, profiles, or native modular references are required. The source code is marked MIT-licensed; the specification is separately marked CC BY 4.0.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about GEML — a plain Text document format built to be edited in place, one section at a time

GEML — a plain-text document format built to be edited in place, one section at a time is an MCP server that works with Markdown and GEML documents. Its main tools are list, find, get, set, replace, and history operations: agents can locate blocks, read or change targets, replace text, and save revisions.

It documents GEML command examples such as `geml list`, `geml get`, `geml set`, and `geml history save`, and links to a browser-based Playground that requires no installation.

It supports Markdown files and GEML files. Markdown can be listed, searched, read, and updated without conversion, while `.geml` files provide finer-grained addressing for blocks and nested values.

Yes, invalid writes are refused before they are applied. GEML validates the complete document after a targeted change and preserves bytes outside the edited region, according to the repository description.

Related MCP servers

All in File Systems All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGEML — a plain Text document format built to be edited in place, one section at a time AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/geml-a-plain-text-document-format-built-to-be-edited-in-place-on?style=directory)](https://allmcps.com/mcp/geml-a-plain-text-document-format-built-to-be-edited-in-place-on)
HTML Embed
<a href="https://allmcps.com/mcp/geml-a-plain-text-document-format-built-to-be-edited-in-place-on"><img src="https://allmcps.com/api/badge/geml-a-plain-text-document-format-built-to-be-edited-in-place-on?style=directory" alt="GEML — a plain Text document format built to be edited in place, one section at a time on AllMCPs" /></a>