Forgetful Setup

Configure the Forgetful semantic memory MCP server.

Step 1: Check Existing Configuration

First, check if Forgetful is already configured:

claude mcp list | grep -i forgetful

If already configured:

• Ask user if they want to reconfigure
• If no, exit with message: "Forgetful is already configured. Use claude mcp list to see details."
• If yes, remove existing first: claude mcp remove forgetful

Step 2: Choose Setup Type

Ask the user which setup they prefer:

Question: "How would you like to configure Forgetful?"

Options:

1. Standard (Recommended) - Zero config, uses uvx to run Forgetful with SQLite storage. Perfect for most users.
2. Custom - For advanced setups: remote HTTP server, PostgreSQL, custom embeddings, authentication, etc.

Step 3a: Standard Setup

If user chose Standard:

claude mcp add forgetful --scope user -- uvx forgetful-ai

Confirm success:

claude mcp list | grep -i forgetful

Report: "Forgetful is now configured! Your memories will persist in ~/.forgetful/ using SQLite."

Step 3b: Custom Setup

If user chose Custom:

1. Fetch the configuration docs:

WebFetch: https://github.com/ScottRBK/forgetful/blob/main/docs/configuration.md

2. Ask what they need:

   • Remote HTTP server - Connect to Forgetful running elsewhere
   • PostgreSQL backend - Use Postgres instead of SQLite
   • Custom embeddings - Use different embedding model/provider
   • Authentication - API key or OAuth setup

3. Based on their answers, guide them through the relevant configuration options from the docs.

4. Build the appropriate command:

For HTTP remote server:

claude mcp add forgetful --scope user --transport http http://HOST:PORT/mcp

For stdio with environment variables:

claude mcp add forgetful --scope user -e VAR1=value1 -e VAR2=value2 -- uvx forgetful-ai

5. Test the configuration:

claude mcp list | grep -i forgetful

Troubleshooting

If setup fails:

• Check if uvx is installed: which uvx
• For HTTP: verify the server is running and accessible
• Check Claude Code logs for MCP connection errors

Notes

• Configuration is stored in ~/.claude.json and persists across plugin updates
• SQLite database location: ~/.forgetful/forgetful.db
• For full configuration reference: https://github.com/ScottRBK/forgetful/blob/main/docs/configuration.md