list_snippetsLABSCO SUMMARY
List without the code, fetch the code once.
The two-step split is the whole design decision, and it is the right one: listing returns metadata only, so a large library costs almost nothing to search, and the full body arrives only for the snippet you actually chose. Filters on language, tag and group narrow it further before anything is fetched.
What it is
A bridge to CodeMenu, the macOS snippet manager. It reads your snippet library through CodeMenu's local API so an assistant can search it and quote from it.
What you get
- Snippets listed without their code bodies — id, title, description, language, abbreviation, tags and group — which keeps a large library from filling the context (list_snippets)
- Filtering on that same list by search query, language, tag or group
- One snippet fetched in full, code included, once you know which one you want (get_snippet)
- The tags and groups you have defined, listed (list_tags, list_groups)
Requirements
CodeMenu running on the Mac with its API turned on in settings. Node.js. If you enabled key protection in CodeMenu, that key is supplied as an environment setting; otherwise there is nothing to configure. Everything stays local — the API listens on the loopback address.
Setup effort
One command — npm install -g git+https://github.com/Extiri/codemenu-mcp.git
USE CASES
01
Reusing something you wrote months ago
Search the library by keyword, then pull the one that matches in full.
02
Narrowing to one language
Filter the list by language rather than scrolling everything.
03
Remembering how you organised things
List your tags and groups, then filter by one.
04
Quoting a snippet exactly
Fetch it by id so the code comes back verbatim rather than remembered.
4 tools
Listed in project docs. Your client may show a different list.
get_snippetlist_tagslist_groupsBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- codemenu-mcp on PATH
- Node.js >= 18.0.0
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g git+https://github.com/Extiri/codemenu-mcp.gitMCP Clients
Claude Desktop — Global install
CLAUDE DESKTOP — GLOBAL INSTALL · JSON
{
"mcpServers": {
"codemenu": {
"command": "codemenu-mcp",
"env": {
"CODEMENU_API_KEY": "<YOUR_CODEMENU_API_KEY>"
}
}
}
}Claude Desktop — Local build
CLAUDE DESKTOP — LOCAL BUILD · JSON
{
"mcpServers": {
"codemenu": {
"command": "node",
"args": [
"<YOUR_PATH_TO_CODEMENU_MCP>/index.js"
],
"env": {
"CODEMENU_API_URL": "http://127.0.0.1:1300/v1",
"CODEMENU_API_KEY": "<YOUR_CODEMENU_API_KEY>"
}
}
}
}
