Glyph Hold MCP

Local stdio MCP server for connecting Codex and other MCP clients to Glyph Hold.

This repo is intentionally separate from Glyph Hold. It does not access the SQLite database directly. It talks to a running Glyph Hold instance through the public /api/v1 HTTP API.

Requirements

• Python 3.12+
• A running Glyph Hold instance
• A Glyph Hold API key created from the dashboard

Example URL:

GLYPHHOLD_URL=https://glyphhold.example.com

Local Setup

Choose a place on your machine where you keep local tool repos. Clone this repo there:

cd ~/coding_projects
git clone git@github.com:Dosk3n/glyphhold-mcp.git
cd glyphhold-mcp

Create the local Python environment:

python3.12 -m venv .venv
. .venv/bin/activate
pip install -e ".[dev]"

Create the local environment file:

cp .env.example .env

Edit .env:

nano .env

Set:

GLYPHHOLD_URL=https://your-glyphhold-host.example.com
GLYPHHOLD_API_KEY=gh_live_xxxxxxxxxxxxxxxxx

Create GLYPHHOLD_API_KEY from the Glyph Hold dashboard.

Useful scopes:

• memories:read
• memories:write
• secrets:write
• secrets:reveal

Only grant secrets:reveal if you want the MCP client to be able to reveal secret values after an explicit user request.

Codex CLI Config

Find the full path to the cloned repo:

pwd

If pwd prints:

/home/you/coding_projects/glyphhold-mcp

then add this to ~/.codex/config.toml:

[mcp_servers.glyphhold]
command = "/home/you/coding_projects/glyphhold-mcp/.venv/bin/python"
args = ["-m", "glyphhold_mcp.server"]
cwd = "/home/you/coding_projects/glyphhold-mcp"

Use your real path from pwd. The important parts are:

command = <repo path>/.venv/bin/python
cwd     = <repo path>

You do not need to put the API key in Codex config. The MCP server loads GLYPHHOLD_URL and GLYPHHOLD_API_KEY from the .env file in the cloned repo.

Start Codex from any project as normal.

Inside Codex, run:

/mcp

You should see the glyphhold MCP server connected.

TLS Certificate Errors

If a tool returns an error like:

[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed

Python does not trust the certificate chain for your Glyph Hold URL.

Best fix: point the MCP server at the CA bundle that signs your internal certificate:

GLYPHHOLD_CA_BUNDLE=/path/to/ca-bundle.pem

For a trusted private test deployment, you can disable verification in .env:

GLYPHHOLD_VERIFY_SSL=false

Do not use GLYPHHOLD_VERIFY_SSL=false for an internet-facing deployment.

Updating

To update the local MCP server later:

cd ~/coding_projects/glyphhold-mcp
git pull
. .venv/bin/activate
pip install -e ".[dev]"

Tools

Health and categories:

• glyphhold_health
• list_categories

Memory tools:

• list_memories
• get_memory
• search_memories
• prefetch_memories
• find_similar_memories
• prepare_memory_write
• create_memory
• update_memory
• update_memory_confidence
• archive_memory
• supersede_memory
• list_memory_revisions
• restore_memory_revision
• delete_memory

Secret tools:

• search_secrets
• get_secret_metadata
• create_secret
• update_secret
• delete_secret
• reveal_secret
• reveal_secret_env

Secret values are only returned by reveal_secret and reveal_secret_env. Permanent deletes require an exact confirmation value.