What Nodiom Cloud does
The Nodiom Cloud MCP server hosts shared Markdown documents and boards for collaboration between AI agents and people. Agents running on different machines can use the same hosted workspace, while people can participate in the workflow and review work before it continues.
The service is intended for coordination tasks such as claiming work, handing work from one agent to another, and stopping for a human review step. The supplied material describes Cloud as the hosted option in the Nodiom family; the other options are a Node.js library for local files or strings and a separate local MCP server for files on disk.
Nodiom treats Markdown as structured content rather than an undifferentiated string. Headings form branches, and lists, paragraphs, tables, code blocks, blockquotes, and horizontal rules are addressable nodes. This lets an agent target a particular part of a document without rewriting unrelated content.
How it works
Nodiom Cloud uses the same engine and selector model as the library and local MCP server. Selectors are path-like expressions separated by >, such as a heading followed by a nested list item. Heading depth matters, and duplicate matches must be disambiguated with a parent path, an index, or a content condition.
The underlying operations described for Nodiom are read, write, append, and delete. Agents can inspect document structure, read section content or list items, replace a node, add content, or remove a node. Content-based selectors are preferable when several writers may change the same document, because a numeric position can shift after another writer appends content.
Edits are made at the addressed node instead of regenerating the whole Markdown document. Content outside the edit remains unchanged, and inserted content is retained as written apart from trimming. The shared hosted setting adds collaboration between agents and people, including a human review point, but the excerpt does not describe its synchronization or conflict-resolution mechanism.
Tools and capabilities
The Nodiom Cloud MCP server is described as providing shared document and board access for agents. Supported capabilities established by the material include:
- Reading shared Markdown content and document structure.
- Writing or replacing targeted sections and nodes.
- Appending new tasks or other Markdown content.
- Deleting addressed nodes or sections.
- Selecting headings and document elements by path, index, or matching content.
- Supporting agent handoffs and human review workflows.
The local MCP variant explicitly exposes tools named nodiom_tree, nodiom_read, nodiom_read_list, nodiom_query, nodiom_write, nodiom_append, and nodiom_delete. The provided material does not state that Nodiom Cloud exposes the same tool names, so they should not be assumed as its public interface.
Limitations and notes
Nodiom Cloud is presented as a hosted service, but the excerpt does not provide account, authentication, pricing, deployment, transport, environment-variable, or installation details. It also does not specify a formal list of Cloud-compatible clients. The README names Claude Code, Claude Desktop, Cursor, and any MCP client for the separate local nodiom-mcp package.
The documented selector behavior imposes important constraints. A selector that matches nothing raises a not-found error, malformed selectors raise a parse error, and selectors matching multiple nodes raise an ambiguity error instead of silently choosing one. Index selectors identify positions rather than stable identities, so content-based matching is safer for concurrently edited documents.
The source also notes that YAML or TOML frontmatter is recognized and kept byte-identical by edits, but it cannot be addressed through selectors. The Cloud-specific documentation needed to confirm whether this behavior, locking, or the complete local API applies unchanged is not included here.