forgetful-mcp-setup

forgetful-mcp-setup is a skill for Claude Code from ScottRBK/forgetful. It costs 67 tokens per session (674 once invoked), scanned A, original, MIT.

Guidance for connecting coding clients such as Claude Code, Cursor, Copilot, Codex, Gemini, or OpenCode to Forgetful through MCP, a standard way for applications to use external tools. It covers local process connections and network connections.

In plain words
What is it for?
Use it to configure Forgetful in an agent client, connect to a local or deployed server, inspect available operations, and invoke them.
Why use it?
It explains which connection type to choose, how authentication and permissions affect access, and how to verify that the client can reach Forgetful.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: mentions subagents; mentions Claude Code; mentions Codex.

Good fit Use it to configure Forgetful in an agent client, connect to a local or deployed server, inspect available operations, and invoke them.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/scottrbk/forgetful/forgetful-mcp-setup
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add ScottRBK/forgetful --skill forgetful-mcp-setup
Clone the repo
git clone --depth 1 https://github.com/ScottRBK/forgetful

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for forgetful-mcp-setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/scottrbk/forgetful/forgetful-mcp-setup.svg)](https://agentmods.dev/skills/scottrbk/forgetful/forgetful-mcp-setup)
Your own site
<a href="https://agentmods.dev/skills/scottrbk/forgetful/forgetful-mcp-setup"><img src="https://agentmods.dev/badge/skills/scottrbk/forgetful/forgetful-mcp-setup.svg" alt="Measured on agentmods" height="20"></a>
Per session 67 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 674 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 2 findings, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium MCP Rug Pull · line 25
    uvx/uv tool run commands without ==version create a rug-pull risk.
    Fix: Pin the version: uvx package-name==1.2.3
  • medium MCP Rug Pull · line 33
    uvx/uv tool run commands without ==version create a rug-pull risk.
    Fix: Pin the version: uvx package-name==1.2.3
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00067 $0.00674
Opus 5 $0.00034 $0.00337
Sonnet 5 $0.00013 $0.00135
Haiku 4.5 $0.00007 $0.00067

Measured 8d ago against content hash 8228406bbd17, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

forgetful-mcp-setup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/forgetful-mcp-setup/SKILL.md · 64 lines

How it starts

The opening of the file, as written. The whole thing — 64 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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:

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).

Read the full file on GitHub · 64 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 64 lines · 67 tokens per session scan A 8228406bbd17

Subscribe to this mod's changes

forgetful-mcp-setup is a skill published in the GitHub repository ScottRBK/forgetful (298 stars, last pushed 6d ago), licensed MIT. It adds 67 tokens to every session and 674 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

weekly-digests

Generate a serial week-by-week narrative digest of a project's full claude-mem timeline. Splits the timeline into per-ISO-week files, then runs one consecutive subagent per week — each receiving the prior week's carry-forward block — to produce one chapter per ISO week of data. Use when asked for "weekly digests"…

thedotmack/claude-mem · 93 tokens

cloud-sync

Set up or check claude-mem cloud sync with cmem.ai Pro. Use when the user says "set up cloud sync", "sync my memories", "cmem pro", "cloud backup", "sync status", or wants their memory database backed up or synced to their cmem.ai account.

thedotmack/claude-mem · 64 tokens

hivemind-memory

Global team and org memory powered by Activeloop. ALWAYS check BOTH built-in memory AND Hivemind memory when recalling information.

activeloopai/hivemind · 33 tokens

install-openviking-memory

Install and configure the OpenViking long-term memory plugin for OpenClaw via natural conversation. Once installed, the plugin automatically captures facts from chats and recalls relevant context before each reply (auto-capture + auto-recall, cross-session). Covers prerequisites, install through OpenClaw's plugin…

volcengine/OpenViking · 191 tokens

memory-audit-pattern-extraction

A method for investigating repeated mistakes by comparing related memories and checking whether an earlier reminder failed. It looks at where the reminder was stored, when it was created, and whether it was strong enough to prevent the mistake.

Dataojitori/nocturne_memory · 48 tokens

init

Install or update OwnMem in the current repository. Use when the user asks to set up OwnMem, add local project memory for coding agents, or refresh an existing OwnMem installation after a version bump.

grpcer/ownmem · 43 tokens