Connect FontHound to Codex, Cursor and VS Code
Use your own fonts with any AI that runs on your computer. Pick them by eye in FontHound, then hand them over in one of two ways: paste them in, or connect FontHound to your AI app.
Your fonts live on your computer. An AI can use them only if it runs things there: a coding agent such as Codex, Cursor, VS Code with Copilot, Gemini CLI or Claude Code, or a script it writes and runs on your computer (Remotion, HyperFrames, HTML, ffmpeg, Pillow). An AI chat in a browser can't reach your fonts. It can write the code, and you run it on your computer.
Two ways to hand your picks over. Any AI: press Send to AI in FontHound and paste. AI apps that support MCP: connect FontHound once, and the AI opens it, waits for your pick and reads it.
Which AI tools can use your fonts
- Yes: AI that works on your computer. Coding agents in a terminal or an editor, and the scripts they run there. They load fonts by name or from the font file, like any app on your computer.
- No: AI chats in a browser or on your phone. ChatGPT, Gemini or Claude on the web run their code on their own servers, where your fonts aren't. Ask them for the code, then run it on your computer.
- Only with an upload: cloud renderers. A service that renders online needs the font files sent to it. Check each font's licence first. Adobe Fonts can't be uploaded.
Way 1: Send to AI and paste (any AI)
- Open FontHound: the app, or the panel in your editor.
- Type your text, such as your video's title.
- Click + on the fonts you like. Up to five.
- Open the Mockup tab. Set the size, colour, stroke or shadow if you want them kept.
- Click Send to AI. FontHound copies the fonts and the look.
- Paste into your AI tool with Ctrl + V (on a Mac, Cmd + V), and say what you want. For example: "Make a 10-second Remotion title card with these fonts."

The pasted text tells the AI exactly what to do:
- Which fonts: family, style, PostScript name and the font file's location, for each option.
- How to load them: by name first, then from the file. Never swap in another font.
- The look: size, colour, tracking, stroke, shadow and box, plus a CSS recipe for Remotion and HTML.
Every line is in Send your fonts to any AI tool.
Way 2: Connect FontHound to your AI app (MCP)
MCP (Model Context Protocol) is how AI apps connect to tools on your computer. FontHound has its own MCP server, inside the FontHound program. Nothing extra to install, and no Node.js.
Once connected, your AI can:
- offer to let you pick the fonts in FontHound;
- open FontHound with your text already typed in;
- wait until you press Send to AI;
- read the fonts you picked, with their files and the look;
- check which font files may go to an online service.
Using Claude Code? It has a FontHound plugin that sets all this up for you: see FontHound + Claude Code.
1. Find FontHound's program
- Windows, installed for everyone:
C:\Program Files\ FontHound\ fonthound.exe - Windows, installed just for you:
C:\(YOU is your Windows user name)Users\ YOU\ AppData\ Local\ Programs\ FontHound\ fonthound.exe - Mac:
/Applications/FontHound.app/ Contents/ MacOS/ fonthound
Not sure which Windows one? Paste C:\Program Files\FontHound into File Explorer's address bar. If fonthound.exe is there, use the first path. The examples below use it. On a Mac, if FontHound is in the Applications folder of your home folder, use /Users/.
The server starts with one extra word after the program: --mcp.
2a. Codex (CLI, app or IDE extension)
- Open Codex's settings file:
.codex\config.tomlin your user folder (on a Mac,~/.codex/config.toml). Create it if it isn't there. - Add these lines and save.
Windows:
[mcp_servers.fonthound] command = 'C:\Program Files\FontHound\fonthound.exe' args = ["--mcp"] tool_timeout_sec = 600
Mac:
[mcp_servers.fonthound] command = "/Applications/FontHound.app/Contents/MacOS/fonthound" args = ["--mcp"] tool_timeout_sec = 600
Codex stops a tool after 60 seconds unless told otherwise. tool_timeout_sec = 600 gives you ten minutes to pick. Codex's CLI, app and IDE extension share this file.
2b. Cursor
- Open
.cursor\mcp.jsonin your user folder (on a Mac,~/.cursor/mcp.json). Create it if it isn't there. - Paste this and save. If the file already has servers, add the
"fonthound"part inside its"mcpServers".
Windows:
{
"mcpServers": {
"fonthound": {
"type": "stdio",
"command": "C:\\Program Files\\FontHound\\fonthound.exe",
"args": ["--mcp"]
}
}
}
Mac:
{
"mcpServers": {
"fonthound": {
"type": "stdio",
"command": "/Applications/FontHound.app/Contents/MacOS/fonthound",
"args": ["--mcp"]
}
}
}
In these JSON files, every backslash in a Windows path is written twice.
2c. VS Code (GitHub Copilot, agent mode)
- Press Ctrl + Shift + P (on a Mac, Cmd + Shift + P) and run MCP: Open User Configuration. For one project only, use
.vscode/mcp.jsonin that project instead. - Paste this and save. VS Code's file uses
"servers", not"mcpServers".
Windows:
{
"servers": {
"fonthound": {
"type": "stdio",
"command": "C:\\Program Files\\FontHound\\fonthound.exe",
"args": ["--mcp"]
}
}
}
Mac:
{
"servers": {
"fonthound": {
"type": "stdio",
"command": "/Applications/FontHound.app/Contents/MacOS/fonthound",
"args": ["--mcp"]
}
}
}
VS Code asks whether you trust a new server. Check that the command is FontHound's program, then allow it. In the chat, use agent mode.
2d. Gemini CLI or Antigravity CLI
Google moved many Gemini CLI users to Antigravity CLI on 18 June 2026. Each keeps its own file.
Gemini CLI: open .gemini\settings.json in your user folder (on a Mac, ~/.gemini/settings.json) and add "mcpServers" at the top level:
{
"mcpServers": {
"fonthound": {
"command": "C:\\Program Files\\FontHound\\fonthound.exe",
"args": ["--mcp"]
}
}
}
Antigravity CLI: open .gemini\config\mcp_config.json in your user folder (on a Mac, ~/.gemini/config/mcp_config.json):
{
"mcpServers": {
"fonthound": {
"command": "C:\\Program Files\\FontHound\\fonthound.exe",
"args": ["--mcp"],
"timeoutSeconds": 600
}
}
}
On a Mac, put "/Applications/FontHound.app/Contents/MacOS/fonthound" after "command": in either file.
Antigravity stops a tool after 180 seconds unless told otherwise. "timeoutSeconds": 600 gives you ten minutes to pick.
3. Restart the app and check
- Close your AI app and open it again, or start a new session.
- Check that FontHound is connected:
- Codex, Gemini CLI, Antigravity CLI: type
/mcpand press Enter. - Cursor: open Customize from the sidebar and find FontHound among the MCP servers. Errors show in the Output panel under MCP Logs.
- VS Code: open Configure Tools in the chat box.
- Codex, Gemini CLI, Antigravity CLI: type
- You should see FontHound with six tools:
offer_font_picking,open_fonthound,wait_for_selection,get_font_selection,get_font_filesandfonthound_status.
4. Pick your fonts
- Ask for something with text, and add one sentence:
Make a 10-second Remotion intro that says Lemon Season. Let me pick the fonts in FontHound first.
- The AI opens FontHound with your text in every font you have, Adobe Fonts included.
- Click + on the fonts you like, open the Mockup tab, and click Send to AI.
- Go back to the AI. It reads your pick and builds with exactly those fonts.
- Why ask in words? Some AI apps call a tool only when you mention it. Saying "FontHound" makes sure.
- Already pressed Send to AI? Say "Use the fonts I sent from FontHound." The AI reads them without opening anything.
- The AI never picks the fonts for you. FontHound has no tool that lists or recommends fonts. You pick, the AI uses your pick.
How the AI should load your fonts
FontHound tells the AI all of this. If your AI gets it wrong, paste the line that fits.
- By name first. HTML, Remotion and HyperFrames load installed fonts by their full name or PostScript name.
- Then from the file. ffmpeg's drawtext and Pillow need the font file: use the path FontHound gave. In Remotion, copy the file into
public/and load it withstaticFile(). - Adobe Fonts by name only. FontHound never hands over their files. They work in HTML and Remotion while Creative Cloud is running and the font is installed, not only added (Add vs Install). Tools that need a file, like ffmpeg or Pillow, can't use them.
- Never a stand-in. If a font won't load, the AI should stop and say so, not quietly use another font.
Before any font file goes online. Rendering on your computer needs no upload. If a step would send a font file to an online service, only open-licence fonts may go. With MCP, the AI checks each font's licence with get_font_files first. For any other font it should ask you, and never upload by default. Adobe Fonts never.
If it doesn't work
- FontHound isn't listed, or shows as failed. Check the path: paste it into File Explorer's address bar (on a Mac, into Finder's Go > Go to Folder, without the last part). Fix the path in the file, then restart the AI app.
- JSON error when the app starts. A Windows path in JSON needs double backslashes. Check for a missing comma when you added FontHound next to other servers.
- The AI never opens FontHound. Say "Let me pick the fonts in FontHound." If it still doesn't, check that FontHound is listed (step 3).
- The wait timed out. Say "I sent the fonts." The AI reads your pick. Then raise the timeout in the file, as in the Codex and Antigravity examples.
- The AI doesn't see your Send to AI. FontHound has to be in its trial or licensed. Then press Send to AI again.
- The AI used another font. Say: "Use exactly the fonts from FontHound. Don't substitute." If it renders online, it can't reach your fonts: render on your computer.
- An old FontHound. Update FontHound: the MCP server is built into current versions.
Questions
Can ChatGPT or Gemini in my browser use my installed fonts?
No. A chat in a browser runs its code on the AI company's servers, where your fonts aren't. Paste your fonts from FontHound, ask for the code, and run it on your computer. Or use an AI agent that works on your computer.
Which AI apps work with FontHound's MCP server?
Any app that runs local MCP servers (stdio). This guide shows Codex, Cursor, VS Code, Gemini CLI and Antigravity CLI. Claude Code has its own plugin. For other apps, use the same program and the word --mcp in that app's MCP settings.
Do I need Node.js or anything else?
No. The server is part of FontHound's own program on Windows and Mac. You only add it to your AI app's settings.
Does FontHound send my fonts or my prompts anywhere?
No. The server runs on your computer and uses no network. It reads only the fonts you sent from FontHound, and nothing from your conversations.
Will the AI choose fonts for me?
No. FontHound has no tool that lists your fonts or recommends any. You pick by eye, and the AI uses exactly your pick.
Can the AI use my Adobe Fonts?
Yes, by name, in renders on your computer such as HTML or Remotion, while Creative Cloud is running and the font is installed. Not in tools that need a font file, and never in an online service.
Sources
Each app's own MCP documentation, checked on 3 November 2026:
- Model Context Protocol (Codex: config.toml, tool_timeout_sec)
- Model Context Protocol (MCP) (Cursor: mcp.json)
- MCP configuration reference (VS Code: mcp.json, MCP: Open User Configuration)
- MCP servers with the Gemini CLI (Gemini CLI: settings.json)
- MCP (Antigravity: mcp_config.json, timeoutSeconds)
- Transitioning Gemini CLI to Antigravity CLI (Google, 18 June 2026)
- Model Context Protocol (what MCP is)
We tested FontHound's server (version 1.0.4) with the official MCP Inspector on Windows: it answers and lists the six tools above. Our Mac build check starts the same server on a Mac and lists its tools.