# Thymercli

> MCP server and CLI for Thymer: connect AI agents and your terminal to your workspaces

- **Type:** MCP server
- **Install:** `agentstack add mcp-thymerapp-thymercli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [thymerapp](https://agentstack.voostack.com/s/thymerapp)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [thymerapp](https://github.com/thymerapp)
- **Source:** https://github.com/thymerapp/thymercli

## Install

```sh
agentstack add mcp-thymerapp-thymercli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# thymercli

A companion app for [Thymer](https://thymer.com) that provides an MCP server for connecting AI agents and a command-line interface for direct workspace access.

See [thymer.com/mcp](https://thymer.com/mcp) for full documentation, setup instructions, and downloads.

## Features

- **MCP Server** — Exposes your Thymer workspaces to AI agents (Claude Code, Cursor, Gemini CLI, etc.) via the [Model Context Protocol](https://modelcontextprotocol.io/)
- **CLI** — Manage workspaces, collections, pages, journal, plugins, themes, and more from the terminal
- **Interactive REPL** — Run commands interactively while the MCP server runs in the background
- **Markdown Mirror** — Continuously export workspaces as markdown files to a local directory for grepping and reading

## How it works

```
┌─────────────┐       HTTP/JSON-RPC        ┌─────────────┐      WebSocket       ┌─────────────┐
│  AI Agent   │ ◄─────────────────────────►│ thymercli   │◄────────────────────►│   Thymer    │
│ (Claude)    │      MCP Protocol          │  (Go app)   │◄────────────────────►│  Org 1...N  │
└─────────────┘                            └─────────────┘                      └─────────────┘
```

thymercli runs locally on your machine. It connects to Thymer in your browser (or the upcoming desktop app) via WebSocket, and serves MCP over HTTP on `127.0.0.1:13100`. Your data never leaves your machine for MCP — it flows directly between Thymer, the local CLI, and your AI agent.

Multiple Thymer organizations can connect simultaneously (e.g., personal.thymer.com and work.thymer.com).

## Building

```bash
go build -o thymercli .
```

## Quick start

```bash
# Start the MCP server and interactive REPL
./thymercli
```

Then connect Thymer via the MCP Settings dialog (statusbar or Command Palette), and point your AI agent to `http://127.0.0.1:13100`.

```bash
# Or use CLI commands directly
./thymercli search "meeting notes"
./thymercli journal
./thymercli page list -w "My Workspace" -c "Tasks"
```

## CLI commands

```
thymercli                          Start MCP server & interactive REPL
thymercli mcp                      Start MCP server explicitly
thymercli status                   Show server status and connected organizations

thymercli workspace list           List available workspaces
thymercli workspace show           Show workspace details

thymercli collection list|show|create|trash|navigate
thymercli page list|show|create|insert|add|move|trash|untrash|navigate
thymercli line edit|delete|move|flag|done
thymercli property list|get|set
thymercli journal [date]           Show or add to journal pages
thymercli search            Full-text search across a workspace
thymercli plugin list|show|update
thymercli theme list|get|set

thymercli mdmirror                 Trigger markdown mirror update
thymercli use                      Set persistent workspace/collection context
```

Use `--json` for structured output, `--workspace`/`--collection` to scope commands, and pipe content via stdin:

```bash
cat notes.md | thymercli page add PAGE_GUID
cat styles.css | thymercli plugin update css PLUGIN_GUID
echo "Shipped v2.0" | thymercli journal add
```

## MCP access

MCP access is opt-in and disabled by default. Each workspace can be set to **Off**, **Read Only**, or **Read & Write** from the MCP Settings dialog in Thymer.

## More information

- [Full documentation & setup guide](https://thymer.com/mcp)
- [Support](https://thymer.com/support)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [thymerapp](https://github.com/thymerapp)
- **Source:** [thymerapp/thymercli](https://github.com/thymerapp/thymercli)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-thymerapp-thymercli
- Seller: https://agentstack.voostack.com/s/thymerapp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.