toolbelt
Provides a tool to list a GitHub user's repositories, ordered by most recent push, with optional GitHub token support for higher API rate limits.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@toolbelt search my notes for anything I wrote about rate limiting"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
toolbelt
A personal MCP server that hands your everyday tools to any AI coding agent. Point Claude Code, Cursor, or Codex at toolbelt and it can read and search your notes, look up GitHub activity, and fetch URLs — in any session, without you pasting context.
Tools
Tool | What it does |
| List a GitHub user's repositories, newest push first |
| Fetch the text content of a URL |
| List note files in your notes directory |
| Read one note by file name |
| Full-text search across your notes (returns |
Related MCP server: almanac
Install
npm install -g toolbelt-mcp # or: git clone … && npm install && npm run buildRegister with your agent
For Claude Code, add to your MCP config:
{
"mcpServers": {
"toolbelt": {
"command": "toolbelt",
"env": {
"TOOLBELT_NOTES_DIR": "/Users/you/notes",
"GITHUB_TOKEN": "ghp_… (optional, raises rate limits)"
}
}
}
}The agent then sees the five tools above and can call them during any conversation.
Configuration
TOOLBELT_NOTES_DIR— directory the note tools read (default: current directory).GITHUB_TOKEN— optional, for higher GitHub API rate limits.
Note reads are restricted to the configured directory (path traversal is stripped).
Develop
npm install
npm run build
npm test # unit tests for the tool logic
npm run dev # run the server over stdioRoadmap
More tools: calendar, email (IMAP), filesystem writes behind confirmation, HTTP POST.
Resources (expose notes as MCP resources, not just tools).
Per-tool allow/deny configuration.
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Available Tools
5 toolsfetch_urlFetch URLA
Fetch the text content of a URL (first 10k chars).
Inputs: url (required).
github_reposGitHub reposC
List a GitHub user's repositories, newest push first.
Inputs: user (required).
list_notesList notesA
List note files in the configured notes directory.
Inputs: no named parameters.
read_noteRead noteB
Read one note by file name from the notes directory.
Inputs: name (required).
search_notesSearch notesB
Full-text search across notes; returns file:line matches.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a clearly different resource: GitHub repos, arbitrary URLs, and notes files. The only mild overlap is between list_notes (enumerate files) and search_notes (content matches with file:line), but the descriptions make the distinction clear.
Four of five tools follow a verb_noun pattern (fetch_url, list_notes, read_note, search_notes). github_repos breaks the pattern with a noun-only name and abbreviation, a minor deviation in an otherwise predictable set.
Five tools is well within the sweet spot for a small read-only utility server, and each has a distinct job. Nothing feels padded or redundant.
The notes surface is read-only: list, read, and search exist but there is no create_note, update_note, or delete_note, which agents will likely need. Similarly, github_repos exposes only repo listing with no related operations, leaving the toolbelt noticeably one-directional.
Related MCP Connectors
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Private memory for AI agents: save and recall facts across Claude Code, Codex, Cursor and ChatGPT.
Shared memory for coding agents. Stop re-explaining your codebase every session.
Durable memory, headless browser and research for agents. Pay per call: x402 USDC on Base or credits
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to inspect local Git repositories and interact with the GitHub API for reading commits, diffs, files, issues, comments, pull requests, and project boards.10133 npmISC
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to capture, search, and recall persistent knowledge notes with epistemic metadata, automatically injecting relevant context into their sessions.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to browse and read notes and view images saved via a browser extension, including note text, source links, and selected images, all read-only and locally.47 npmMIT

Graphicle MCP Serverofficial
AlicenseBqualityAmaintenanceEnables coding agents to query a repository's code graph and project memory through cited excerpts, navigate symbols and dependencies, and optionally inspect pull requests, all within a configurable token budget.22581Apache 2.0