goodmem-claude-code-plugin
GoodMem Claude Code plugin — Skills + MCP server for memory infrastructure
Install / Use
claude mcp add PAIR-Systems-Inc -- npx -y github:PAIR-Systems-Inc/goodmem-claude-code-pluginIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Tags
Our assessment of goodmem-claude-code-plugin
goodmem-claude-code-plugin scores 80/100 on our quality scale, 751st of 944 AI & Machine Learning skills we index.
Its MCP Server is 7.6 KB long, well organised into 14 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 12 days ago, so goodmem-claude-code-plugin is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-19. Automated pattern scan on 2026-11-19. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
goodmem-claude-code-plugin compared with similar skills
All 4 of these similar skills score higher than goodmem-claude-code-plugin; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| goodmem-claude-code-plugin (this skill)by PAIR-Systems-Inc | 80 | 10 | 12d ago | MCP Server |
| claude-memby thedotmack | 100 | 118.5k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.3k | 1d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install goodmem-claude-code-plugin?
- Run
claude mcp add PAIR-Systems-Inc -- npx -y github:PAIR-Systems-Inc/goodmem-claude-code-plugin. The install tabs above show the steps for each supported agent. - Which AI agents does goodmem-claude-code-plugin work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is goodmem-claude-code-plugin safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is goodmem-claude-code-plugin still maintained?
- The repository was last updated 12 days ago, so goodmem-claude-code-plugin is actively maintained.
Skill content
View source on GitHubGoodMem Claude Code Plugin
A Claude Code plugin for GoodMem — memory infrastructure for AI agents.
With this plugin, you can operate GoodMem's memory infrastructure in plain English — create and manage embedders, rerankers, and LLMs, ingest memories from files, base64 strings, and plain text, and build knowledge-powered agents for RAG and Deep Research. Also includes Python and Java SDK references for writing GoodMem code.
Use cases
- Deep Research agent — Create an embedder and space, ingest research papers and documents, then ask complex questions that retrieve and synthesize information across your entire knowledge base.
- RAG pipeline — Configure embedders, rerankers, and LLMs, store source materials as memories, and retrieve relevant context for answering questions.
- Self-improving support agent — Ingest historical issue tickets and resolutions, search for solutions matching a new problem description, and iteratively store new discoveries and fixes as memories so future troubleshooting gets smarter over time.
Installation
From the community marketplace (preferred):
/plugin marketplace add anthropics/claude-plugins-community
/plugin install goodmem@claude-community
From this repo (fallback — use only if the community marketplace is unavailable):
/plugin marketplace add PAIR-Systems-Inc/goodmem-claude-code-plugin
/plugin install goodmem@goodmem-plugins
Connecting
The plugin ships two MCP servers. Use either or both.
| Server | Connects to | What the LLM can do | Setup |
|--------|-------------|---------------------|-------|
| goodmem | Your own GoodMem instance, local or remote | Everything: search and read memories, and full control over spaces, memories, models, users, and API keys | Base URL and gm_ API key, from chat or environment variables |
| goodmem-gateway | Your instance on GoodMem Cloud | Search and read, save memories, save documents by URL, delete memories, create and rename spaces. Model setup and administration stay in the Cloud console | Browser sign-in — requires a GoodMem Cloud account with an instance |
goodmem — your own instance (all tools)
Runs npx @pairsystems/goodmem-mcp, the GoodMem MCP server, which exposes the full GoodMem API as tools. Give it a server URL and a gm_ API key in either of two ways:
From chat (lasts for the session): tell Claude your server details and it calls goodmem_configure.
> "Configure GoodMem with base URL http://localhost:8080 and API key gm_abc123"
Call it again anytime to switch servers.
Environment variables (persist across sessions): export before launching Claude Code.
export GOODMEM_BASE_URL="https://your-server.example.com"
export GOODMEM_API_KEY="gm_..."
goodmem-gateway — GoodMem Cloud
Connects to your GoodMem Cloud instance through PAIR's hosted gateway. You need a GoodMem Cloud account with an instance — there is no API key or URL to enter.
- Run
/mcpinside Claude Code, select goodmem-gateway, and choose Authenticate. - Sign in on the GoodMem page that opens in your browser and choose your instance.
- The server shows as connected. Claude Code stores and refreshes the token, so this is a one-time step per machine.
The gateway is intended for single-owner instances until per-user identity is supported. Gateway calls currently act with the instance's root authority rather than applying the signed-in user's individual GoodMem permissions, so every user who connects to an instance through the gateway has the same privileges on it, and the instance's audit records attribute their actions to the root user. Per-user identity is tracked in goodmem-cloud-provisioning#5455.
To switch instances or sign out, run /mcp → goodmem-gateway → Clear authentication, then sign in again. Spaces can be created and renamed through the gateway, but deleting a space is done in the GoodMem Cloud console. Embedders, rerankers, and LLMs for a cloud instance are set up there too; Claude gives you a one-time link when one is needed. Searches are reranked automatically with the first reranker on your instance, and Claude can ask for an answer generated by the first LLM on it.
TLS certificates
- Localhost: run the server with TLS disabled and connect over
http://localhost:8080. New installs:goodmem system install --tls-disabled. Existing installs: setGOODMEM_TLS_DISABLED=truein the server's environment and restart it. - Remote server with a private or self-signed CA: export
NODE_EXTRA_CA_CERTSwith the absolute path of the CA's PEM file before launching Claude Code, and restart Claude Code after changing it. - An expired or invalid server certificate must be fixed on the server.
Reloading after updates
After installing a new version or pulling the latest changes, run /reload-plugins inside Claude Code to pick up the updates without restarting. If you are using the plugin from this repo, you can run git pull to get the latest changes.
What's included
| Component | Description |
|-----------|-------------|
| skills/help/ | Setup guide, available skills overview, example workflows |
| skills/python/ | Python SDK reference — method signatures, parameters, examples |
| skills/java/ | Java SDK usage reference — setup, builders, streaming, pagination, examples |
| skills/mcp/ | MCP workflow guide; tool discovery provides current parameters |
| .mcp.json | Two MCP servers: goodmem (all tools, your own instance) and goodmem-gateway (GoodMem Cloud) |
Skills
goodmem:help— Overview of all skills, setup instructions, example workflowsgoodmem:python— Python SDK reference for writing GoodMem codegoodmem:java— Java SDK reference for writing GoodMem codegoodmem:mcp— MCP tools reference for direct operations
MCP tools
The goodmem server exposes all GoodMem API operations as tools:
- goodmem_configure — set server credentials from chat
- goodmem_lookup_model — look up model info from the built-in registry
- embedders — create, list, get, update, delete embedding models
- llms — create, list, get, update, delete LLM configurations
- rerankers — create, list, get, update, delete reranker models
- spaces — create, list, get, update, delete memory spaces
- memories — create, list, get, update, delete, retrieve (with optional reranking and LLM answers), batch operations
- ocr — extract text from documents
- users, apikeys, system, admin — manage users, API keys, server
Auto-inference
When creating embedders, LLMs, or rerankers, just provide model_identifier and the plugin auto-fills provider, endpoint, dimensions, and other fields from the built-in model registry. You only need to provide display_name, model_identifier, and credentials — everything else is inferred.
Explicit values always override inferred defaults.
Credential validation
SaaS providers (OpenAI, Cohere, Voyage, Jina, and OpenAI-compatible endpoints for Anthropic, Google, Mistral) require API credentials. If you create an embedder, LLM, or reranker pointing at a known SaaS hostname without providing credentials, the plugin raises a clear error before the request reaches the server. Pass credentials (MCP), api_key (Python SDK), or the provider API key overload (Java SDK) to proceed.
Links
Related Skills
claude-mem
118.5kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.3kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
