RepeaterBook — Claude Code MCP server: ham repeater lookup
Looks up amateur radio repeaters on RepeaterBook.com by location, band and mode. Useful when the agent is putting together a frequency list for a trip.
claude mcp add --env REPEATERBOOK_APP_TOKEN=<REPEATERBOOK_APP_TOKEN> --env REPEATERBOOK_WORKING_DIR=<REPEATERBOOK_WORKING_DIR> --env REPEATERBOOK_APP_CONTACT=<REPEATERBOOK_APP_CONTACT> --transport stdio repeaterbook -- uvx repeaterbookWhat RepeaterBook does
RepeaterBook registers as an MCP server in Claude, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed and Gemini CLI, handing your agent repeater data from RepeaterBook.com. Queries narrow by location, band and mode; the agent decides what to show.
The server runs as uvx repeaterbook, so uv has to be on the machine. A REPEATERBOOK_APP_TOKEN is required — pass it as an environment variable when you register the server, otherwise it will not start. The Cursor and GitHub Copilot configs also carry REPEATERBOOK_WORKING_DIR and REPEATERBOOK_APP_CONTACT.
Claude Code takes two forms of registration: a short one with just the token, and a fuller one that sets all three variables and spells out --transport stdio. Behind a proxy or a private package mirror, configure that in your environment or the tool's config file rather than on the install line.
What it helps with
- pull up repeaters near a given location
- filter repeaters by band and mode
- build a frequency list for travel
- check which repeaters cover an area
- query RepeaterBook without leaving the chat
Example prompts for the agent
- Find repeaters within 50 km of my city on the 2 m band
- Show DMR repeaters in this region
- List 70 cm repeaters for my trip
How to install RepeaterBook
Platform CLI
claude mcp add --env REPEATERBOOK_APP_TOKEN=<REPEATERBOOK_APP_TOKEN> --env REPEATERBOOK_WORKING_DIR=<REPEATERBOOK_WORKING_DIR> --env REPEATERBOOK_APP_CONTACT=<REPEATERBOOK_APP_CONTACT> --transport stdio repeaterbook -- uvx repeaterbookReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from repeaterbook <command>
Platform CLI
codex mcp add repeaterbook --env REPEATERBOOK_APP_TOKEN=<REPEATERBOOK_APP_TOKEN> --env REPEATERBOOK_WORKING_DIR=<REPEATERBOOK_WORKING_DIR> --env REPEATERBOOK_APP_CONTACT=<REPEATERBOOK_APP_CONTACT> -- uvx repeaterbookReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from repeaterbook <command>
Config file
{
"mcpServers": {
"repeaterbook": {
"command": "uvx",
"args": [
"repeaterbook"
],
"env": {
"REPEATERBOOK_APP_TOKEN": "<REPEATERBOOK_APP_TOKEN>",
"REPEATERBOOK_WORKING_DIR": "<REPEATERBOOK_WORKING_DIR>",
"REPEATERBOOK_APP_CONTACT": "<REPEATERBOOK_APP_CONTACT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from repeaterbook <command>
Config file
{
"servers": {
"repeaterbook": {
"type": "stdio",
"command": "uvx",
"args": [
"repeaterbook"
],
"env": {
"REPEATERBOOK_APP_TOKEN": "<REPEATERBOOK_APP_TOKEN>",
"REPEATERBOOK_WORKING_DIR": "<REPEATERBOOK_WORKING_DIR>",
"REPEATERBOOK_APP_CONTACT": "<REPEATERBOOK_APP_CONTACT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from repeaterbook <command>
Platform CLI
gemini mcp add -e REPEATERBOOK_APP_TOKEN=<REPEATERBOOK_APP_TOKEN> -e REPEATERBOOK_WORKING_DIR=<REPEATERBOOK_WORKING_DIR> -e REPEATERBOOK_APP_CONTACT=<REPEATERBOOK_APP_CONTACT> repeaterbook uvx repeaterbookReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from repeaterbook <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about RepeaterBook
How do I install RepeaterBook in Claude Code?
Run claude mcp add repeaterbook -e REPEATERBOOK_APP_TOKEN=<REPEATERBOOK_APP_TOKEN> -- uvx repeaterbook, replacing the token with your own.
What does RepeaterBook do?
It gives your agent access to the RepeaterBook.com amateur radio repeater database, filtered by location, band and mode.
What does the server need to run?
uv installed so uvx can launch it, plus a token in REPEATERBOOK_APP_TOKEN. Without the token the server will not start.
