New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Forgetful MCP Client Setup

by ScottRBK in ScottRBK/forgetful

Connects an MCP client to the Forgetful memory server over stdio or HTTP, then confirms the link works with discovery and round-trip calls.

MITAuto-check passedAgent Workflows

Install Forgetful MCP Client Setup

skills CLI
$ npx skills add ScottRBK/forgetful --skill forgetful-mcp-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ScottRBK/forgetful forgetful-mcp-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ScottRBK/forgetful.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/forgetful-mcp-setup .claude/skills/forgetful-mcp-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
forgetful-mcp-setup
GitHub stars
301
Token cost
~682 tokens
SKILL.md length
275 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Connects an MCP client to the Forgetful memory server over stdio or HTTP, then confirms the link works with discovery and round-trip calls.

  • Works in 2 steps: discover_forgetful_tools returns… → One execute_forgetful_tool round-trip…
  • Wiring Claude Code, Cursor, Codex, Gemini or Copilot to a Forgetful server
  • SKILL.md covers Pick a transport, Auth and scopes, Verify — the completion… and Delegation boundary
  • Calls claude and uvx

What it does

Every MCP client connecting to Forgetful sees the same three tools: one that lists tool categories, one that returns the docs and schema for a single tool, and one that runs a tool by name with a JSON arguments object. This skill walks you through pointing a client at the server, using Claude Code as the worked example with `claude mcp add` for both stdio (`uvx forgetful-ai`) and HTTP (`http://localhost:8020/mcp`).

It also covers authentication and scopes. A local server runs without auth for a single user, while deployed servers use bearer tokens or OAuth, and a `FORGETFUL_SCOPES` setting on the server can cap a client at read-only. Setup counts as finished only when discovery returns categories matching the server's enabled features and one real call, such as `get_current_user` or `list_projects`, returns data in a fresh session.

Subagents do not inherit MCP tool access, so memory calls stay in the main conversation. Work handed to a subagent should use the `forgetful` command line through Bash, which a separate CLI setup skill describes.

When your agent uses it

  • Wiring Claude Code, Cursor, Codex, Gemini or Copilot to a Forgetful server
  • Deciding between a local stdio setup and a shared HTTP deployment
  • Limiting a client to read-only recall with server-side scopes
  • Confirming a newly configured client really returns data in a fresh session

Example prompts

  • “Wire Claude Code to my local Forgetful server over stdio and verify it works.”
  • “Set up Forgetful over HTTP at http://localhost:8020/mcp for the Cursor installs on my team.”
  • “Make our Gemini client read-only against Forgetful so it can recall but not write.”
  • “Explain why my subagent cannot call the Forgetful tools and how to delegate memory work to it.”

Requirements

  • `uvx` to run `forgetful-ai` for stdio
  • A running Forgetful server for HTTP transport
  • Pre-approved tools (allowed-tools): mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. discover_forgetful_tools returns categories, and they match the server's enabled
  2. One execute_forgetful_tool round-trip returns real data — get_current_user or

What it can do on your machine

Read from SKILL.md and the folder at commit ff45893. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • mcp__forgetful__discover_forgetful_tools
    • mcp__forgetful__how_to_use_forgetful_tool
    • mcp__forgetful__execute_forgetful_tool

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • uvx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uvx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Forgetful MCP Client Setup loads about 682 tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 275 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~682

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ScottRBK/forgetful at commit ff45893, republished under its MIT licence (© ScottRBK). 275 words, ~682 tokens.

Download SKILL.mdSave it as .claude/skills/forgetful-mcp-setup/SKILL.md (or your agent's skills folder).
name
forgetful-mcp-setup
description
Set up an MCP client for Forgetful — wire Claude Code, Cursor, Copilot, Codex, Gemini, or OpenCode to the server and verify the connection behaves. Covers stdio vs HTTP transport, auth and scopes, the three meta-tools every client sees, and delegation to subagents.
allowed-tools
mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool
license
MIT
disable-model-invocation
true
tags
mcp, setup, clients, transport, auth

Setting up an MCP client

Every MCP client sees the same three tools fronting the full registry: discover_forgetful_tools (what exists, by category), how_to_use_forgetful_tool (one tool's docs and schema), execute_forgetful_tool (invoke by name with a JSON arguments object). Roughly 500 tokens of surface, with everything else disclosed at runtime.

Pick a transport

  • stdio — the client spawns the server per session: command uvx forgetful-ai (equivalently forgetful serve --transport stdio). Right for a personal, local setup.
  • HTTP — the client connects to a running server at <server>/mcp, e.g. http://localhost:8020/mcp. Right for a shared or deployed instance.

Claude Code, as the worked example:

bash
claude mcp add forgetful -- uvx forgetful-ai                          # stdio
claude mcp add --transport http forgetful http://localhost:8020/mcp  # HTTP

Other clients follow the same two shapes (spawn command, or HTTP endpoint) in their own config format — full per-client walkthroughs live in docs/connectivity_guide.md in the Forgetful repo.

Auth and scopes

A local server defaults to no-auth single-user mode — connect and go. Deployed servers use bearer tokens or OAuth (the server's configured provider). FORGETFUL_SCOPES on the server side sets a capability ceiling (e.g. read-only) that both MCP and CLI honour; a client that should only recall can be scoped so writes are refused.

Verify — the completion criterion

Behavioural, not configurational:

  1. discover_forgetful_tools returns categories, and they match the server's enabled feature flags (skills/files/plans appear only when enabled).
  2. One execute_forgetful_tool round-trip returns real data — get_current_user or list_projects both work as smoke calls.

Done when: both pass in the client that was just wired, in a fresh session.

Delegation boundary

Run Forgetful MCP calls in the main conversation — subagents do not inherit MCP tool access. When work must be delegated to a subagent, give it the CLI surface instead (Bash with the forgetful command travels into subagents; see forgetful-cli-setup).

© ScottRBK, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/forgetful-mcp-setup of ScottRBK/forgetful.

Open the folder on GitHubat commit ff45893

Compare with similar skills

Forgetful MCP Client Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Forgetful MCP Client Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Forgetful MCP Client Setup this skillScottRBK/forgetful301—~682Automated safety check: PassMIT
Ruflo Multi-Agent Orchestrationruvnet/ruflo74k1 repos~975Automated safety check: PassMIT
MemPalace Setup and OperationMemPalace/mempalace59k—~2.2kAutomated safety check: PassMIT
agentmemory Setup and Diagnosticsrohitg00/agentmemory29k—~1kAutomated safety check: NotesApache-2.0
Qmdbreferrari/obsidian-mind5k—~1.7kAutomated safety check: PassMIT
Claude Automation Recommenderanthropics/claude-plugins-official38k3 repos~2.7kAutomated safety check: NotesApache-2.0

Similar skills

  • Ruflo Multi-Agent Orchestration

    ruvnet/ruflo

    Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Agent WorkflowsAuto-check passed

  • MemPalace Setup and Operation

    MemPalace/mempalace

    Installs and configures MemPalace as a private local palace, a shared-brain hub or a client of an existing hub, including MCP registration and version-correct initialization.

    59k GitHub stars~2.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

  • agentmemory Setup and Diagnostics

    rohitg00/agentmemory

    Sets up and troubleshoots a local agentmemory install, covering the MCP connection, environment variables, ports, authentication and optional feature flags.

    29k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check: notes

  • Qmd

    breferrari/obsidian-mind

    Search the vault using QMD semantic search. An agent skill from breferrari/obsidian-mind.

    5k GitHub stars~1.7k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

  • Claude Automation Recommender

    anthropics/claude-plugins-official

    Official

    Scans a codebase and suggests which Claude Code hooks, subagents, skills, plugins and MCP servers fit its stack, without changing any files.

    38k GitHub starsUsed in 3 repos~2.7k tokens
    Agent WorkflowsAuto-check: notes

  • CC Workflow Studio AI Editor

    breaking-brake/cc-wf-studio

    Creates and edits visual agent workflows in CC Workflow Studio through conversation, with the agent reading and writing the canvas over MCP.

    5.4k GitHub stars~561 tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from ScottRBK/forgetful

All 10 skills in this repo

  • Forgetful CLI Setup

    ScottRBK/forgetful

    Installs and connects the Forgetful CLI in local or remote mode, sets up token auth for CI, and proves the setup with a real round-trip call.

    301 GitHub stars~898 tokensUpdated today
    Auto-check: notes

  • Forgetful Remember

    ScottRBK/forgetful

    Decides where a piece of knowledge belongs in the Forgetful memory server, checks for existing entries first, then creates and links it without deleting anything.

    301 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

  • Forgetful Repo Encoding

    ScottRBK/forgetful

    Encodes a repository into the Forgetful knowledge base as a project, entities, atomic memories and documents, so a second run updates instead of duplicating.

    301 GitHub stars~1k tokensUpdated today
    Auto-check passed

  • Forgetful Entity Modeling

    ScottRBK/forgetful

    Models people, organisations, devices, products and system components as entities in a Forgetful knowledge graph, then links memories and relationships to them.

    301 GitHub stars~836 tokensUpdated today
    Auto-check passed

  • Forgetful Knowledge Graph Explorer

    ScottRBK/forgetful

    Explores the Forgetful memory graph in phases, walking memories, entities and relationships to answer cross-project and entity-centred questions.

    301 GitHub stars~898 tokensUpdated today
    Auto-check passed

  • Forgetful File Storage

    ScottRBK/forgetful

    Stores screenshots, PDFs, diagrams, fonts and other binary files in the Forgetful knowledge base, with a retrieval-friendly description and an attachment route.

    301 GitHub stars~618 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Forgetful MCP Client Setup

What does Forgetful MCP Client Setup do?

Connects an MCP client to the Forgetful memory server over stdio or HTTP, then confirms the link works with discovery and round-trip calls. Every MCP client connecting to Forgetful sees the same three tools: one that lists tool categories, one that returns the docs and schema for a single tool, and one that runs a tool by name with a JSON arguments object. This skill walks you through pointing a client at the server, using Claude Code as the worked example with `claude mcp add` for both stdio (`uvx forgetful-ai`) and HTTP (`http://localhost:8020/mcp`).

When should I use Forgetful MCP Client Setup?

Forgetful MCP Client Setup fits situations like: wiring Claude Code, Cursor, Codex, Gemini or Copilot to a Forgetful server; deciding between a local stdio setup and a shared HTTP deployment; limiting a client to read-only recall with server-side scopes; confirming a newly configured client really returns data in a fresh session.

How do I install Forgetful MCP Client Setup in Claude Code?

Run `npx skills add ScottRBK/forgetful --skill forgetful-mcp-setup -a claude-code`. Or copy the skill folder (skills/forgetful-mcp-setup in ScottRBK/forgetful) into .claude/skills/forgetful-mcp-setup in your project. Claude Code loads it when a task matches its description.

How do I install Forgetful MCP Client Setup in Codex?

Run `npx skills add ScottRBK/forgetful --skill forgetful-mcp-setup -a codex`. Or copy the skill folder (skills/forgetful-mcp-setup in ScottRBK/forgetful) into .agents/skills/forgetful-mcp-setup in your project. Codex loads it when a task matches its description.

Can I use Forgetful MCP Client Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ScottRBK/forgetful --skill forgetful-mcp-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/forgetful-mcp-setup, .gemini/skills/forgetful-mcp-setup, .github/skills/forgetful-mcp-setup and .opencode/skills/forgetful-mcp-setup in your project.

What does Forgetful MCP Client Setup need to run?

Going by SKILL.md and its folder, Forgetful MCP Client Setup needs the command-line tools its instructions call (claude and uvx). Our summary lists: `uvx` to run `forgetful-ai` for stdio; A running Forgetful server for HTTP transport. Its frontmatter pre-approves these tools: mcp__forgetful__discover_forgetful_tools, mcp__forgetful__how_to_use_forgetful_tool, mcp__forgetful__execute_forgetful_tool.

Does Forgetful MCP Client Setup access the network?

SKILL.md contains no URLs. Its commands use uvx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Forgetful MCP Client Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Forgetful MCP Client Setup use?

Forgetful MCP Client Setup is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Forgetful MCP Client Setup use?

About 682 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Forgetful MCP Client Setup?

Skills that share tags, products or a category with Forgetful MCP Client Setup: Ruflo Multi-Agent Orchestration (ruvnet/ruflo, 74k stars), MemPalace Setup and Operation (MemPalace/mempalace, 59k stars), agentmemory Setup and Diagnostics (rohitg00/agentmemory, 29k stars) and Qmd (breferrari/obsidian-mind, 5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Forgetful MCP Client Setup?

ScottRBK (a GitHub user) maintains it in ScottRBK/forgetful, which has 301 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 8, 2026.

Source: ScottRBK/forgetful on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.