Skip to main content
Glama

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.

CI License: MIT OR Apache-2.0

Tools

Tool

What it does

github_repos

List a GitHub user's repositories, newest push first

fetch_url

Fetch the text content of a URL

list_notes

List note files in your notes directory

read_note

Read one note by file name

search_notes

Full-text search across your notes (returns file:line matches)

Related MCP server: almanac

Install

npm install -g toolbelt-mcp     # or: git clone … && npm install && npm run build

Register 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 stdio

Roadmap

  • 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 tools
fetch_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

    B3.4/5.0

    Scored across 5 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      10
      133 npm
      ISC
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables coding agents to capture, search, and recall persistent knowledge notes with epistemic metadata, automatically injecting relevant context into their sessions.
      1
      MIT
    • A
      license
      B
      quality
      A
      maintenance
      Enables 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.
      22
      581
      Apache 2.0