Typst
Typst MCP Server is an MCP (Model Context Protocol) implementation that helps AI models interact with Typst, a markup-based typesetting system. The server provides tools for converting between LaTeX and Typst, validating Typst syntax, and generating
What is Typst?
Typst is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to typst mcp server is an mcp (model context protocol) implementation that helps ai models interact with typst, a markup-based typesetting system. the server provides tools for converting between latex a...
Typst MCP Server is an MCP (Model Context Protocol) implementation that helps AI models interact with Typst, a markup-based typesetting system. The server provides tools for converting between LaTeX and Typst, validating Typst syntax, and generating
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Typst MCP Server is an MCP (Model Context Protocol) implemen
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx typstConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Typst
The Typst MCP Server enables AI assistants to work with Typst, a modern markup-based typesetting system designed as an alternative to LaTeX. It provides tools to convert LaTeX snippets to Typst syntax using Pandoc, validate Typst code for correctness, render Typst documents to PNG images, and browse the official Typst documentation — all from within an AI chat interface. Technical writers, academics, and developers migrating from LaTeX to Typst use it to accelerate document authoring and learn Typst syntax through guided AI assistance.
Prerequisites
- Python 3.10+ with the uv package manager installed
- Typst CLI installed (see typst.app for installation instructions)
- Pandoc installed for LaTeX-to-Typst conversion (pandoc.org/installing.html)
- Git for cloning the repository and generating the documentation bundle
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
Clone the typst-mcp repository
Download the server source code from GitHub.
git clone https://github.com/johannesbrandenburger/typst-mcp.git
cd typst-mcpInstall Typst and Pandoc
Install both required external tools. Typst is available via cargo or system package managers; Pandoc from pandoc.org.
# Install Typst via cargo:
cargo install typst-cli
# Install Pandoc on macOS:
brew install pandocGenerate the Typst documentation bundle
Clone the Typst source repo and run the docs generation command to produce the main.json file that the MCP server uses for documentation lookup.
git clone https://github.com/typst/typst.git ../typst
cd ../typst
cargo run --package typst-docs -- --assets-dir ../typst-mcp/typst-docs --out-file ../typst-mcp/typst-docs/main.json
cd ../typst-mcpInstall Python dependencies
Install all Python dependencies using uv sync.
uv syncConfigure your MCP client
Add the server to your MCP client configuration. Use 'mcp install server.py' for Claude Desktop or add a manual config block for other clients.
mcp install server.pyAlternatively, run via Docker
If you prefer Docker, pull and run the pre-built image without any local dependency setup.
docker pull ghcr.io/johannesbrandenburger/typst-mcp:latest
docker run ghcr.io/johannesbrandenburger/typst-mcp:latestTypst Examples
Client configuration
Add this to your claude_desktop_config.json to run the Typst MCP server. Replace the path with the absolute path to your typst-mcp directory.
{
"mcpServers": {
"typst": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/typst-mcp",
"python",
"server.py"
]
}
}
}Prompts to try
Use these prompts to convert, validate, and render Typst documents through your AI assistant.
- "Convert this LaTeX equation to Typst: \\frac{\\partial u}{\\partial t} = \\nabla^2 u"
- "Is this valid Typst syntax? #set text(font: \"Libertinus Serif\", size: 12pt)"
- "Render this Typst snippet as an image: #align(center)[= My Document Title]"
- "Show me the Typst documentation chapter on tables"
- "Convert my LaTeX bibliography \\bibliographystyle{plain} \\bibliography{refs} to Typst's citation format"Troubleshooting Typst
LaTeX conversion fails with 'pandoc not found' error
Pandoc must be installed and on your PATH before the server can convert LaTeX to Typst. Install it from pandoc.org or via your package manager ('brew install pandoc' on macOS, 'apt install pandoc' on Ubuntu), then restart your MCP client.
Typst rendering fails or produces no output image
Verify the Typst CLI is installed and accessible: run 'typst --version' in your terminal. If it is not found, install it with 'cargo install typst-cli' or download a binary from github.com/typst/typst/releases. The server needs 'typst' on the PATH.
Documentation tools return empty results or errors
The typst-docs/main.json file must be generated before running the server. Follow step 3 to clone the Typst repo and run the docs generation command. Without this file the list_docs_chapters and get_docs_chapter tools will not function.
Frequently Asked Questions about Typst
What is Typst?
Typst is a Model Context Protocol (MCP) server that typst mcp server is an mcp (model context protocol) implementation that helps ai models interact with typst, a markup-based typesetting system. the server provides tools for converting between latex and typst, validating typst syntax, and generating It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Typst?
Follow the installation instructions on the Typst GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Typst?
Typst works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Typst free to use?
Yes, Typst is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Typst Alternatives — Similar Developer Tools Servers
Looking for alternatives to Typst? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Typst in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Typst?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.