| name | release |
| description | Used to release all toolbox, integrations, agents. Use when releasing a subproject to PyPI, Docker Hub, or when the user asks to release or publish. |
Release Workflows
All release workflows are triggered via workflow_dispatch (manual) from the GitHub Actions tab. Bump the version in the subproject's pyproject.toml before dispatching.
Workflow files
| Workflow file | Package | What it does | Secrets used |
|---|
release-mcp-memgraph.yaml | mcp-memgraph | Build & publish to PyPI + Docker Hub | PYPI_TOKEN, DOCKERHUB_USERNAME, DOCKERHUB_TOKEN |
release-toolbox.yaml | memgraph-toolbox | Build & publish to PyPI | PYPI_TOKEN |
release-langchain-memgraph.yaml | langchain-memgraph | Build & publish to PyPI | PYPI_TOKEN |
release-lightrag-memgraph.yaml | lightrag-memgraph | Build & publish to PyPI | PYPI_TOKEN |
release-unstructured2graph.yaml | unstructured2graph | Build & publish to PyPI | PYPI_TOKEN |
Subproject paths
| Package | Path | pyproject.toml version field |
|---|
| memgraph-toolbox | memgraph-toolbox | [project] version |
| mcp-memgraph | integrations/mcp-memgraph | [project] version |
| langchain-memgraph | integrations/langchain-memgraph | [project] version |
| lightrag-memgraph | integrations/lightrag-memgraph | [project] version |
| unstructured2graph | unstructured2graph | [project] version |
Required GitHub secrets
| Secret | Used by | Description |
|---|
PYPI_TOKEN | All release workflows | PyPI API token for uv publish |
DOCKERHUB_USERNAME | release-mcp-memgraph | Docker Hub username |
DOCKERHUB_TOKEN | release-mcp-memgraph | Docker Hub access token |
Notes
- lightrag-memgraph and unstructured2graph use
uv build --out-dir dist to work around a uv artifact path issue.
- The mcp-memgraph Docker image is built from the repo root (the Dockerfile copies both
memgraph-toolbox/ and integrations/mcp-memgraph/).
- The mcp-memgraph workflow tags the Docker image with both the version and
latest.
