Theme Db Extension

Theme-Separated Memory Databases Extension

This extension adds support for multiple, theme-separated memory databases to the mcp-local-memory server.

Features

• Multiple Themes: Create separate memory databases for different projects, topics, or contexts
• Theme Switching: Switch between themes to isolate memory contexts
• Per-Theme Operations: Remember and recall memories within specific themes
• Graph & Entity Support: Create entities, relations, and view knowledge graphs separated by theme
• Theme Management: Create, list, switch, and delete themes

Installation

1. Copy the theme-db-extension directory to your desired location
2. Set the EXTENSIONS_PATH environment variable to point to the extension directory
3. Restart the mcp-local-memory server

export EXTENSIONS_PATH=/path/to/theme-db-extension

Tools Provided

create_theme

Create a new theme-separated memory database. Parameters:

• name (required): Name of the theme (e.g., 'work', 'personal', 'project-x')
• description (optional): Description of what this theme is for

list_themes

List all available themes with their memory counts.

switch_theme

Switch to a different theme. All subsequent memory operations will use the selected theme's database. Parameters:

• name (required): Name of the theme to switch to

delete_theme

Delete a theme and all its associated memories. Parameters:

• name (required): Name of the theme to delete
• confirm (required): Must be true to confirm deletion

get_current_theme

Get the name of the currently active theme.

remember_theme

Remember a fact in a specific theme's database. Includes full vector search and NLP extraction. Parameters:

• text (required): The fact to remember
• theme (optional): Theme name (uses current theme if not specified)
• tags (optional): Array of tags for categorization

recall_theme

Recall memories from a specific theme's database using keyword search. Parameters:

• query (required): Search query
• theme (optional): Theme name (uses current theme if not specified)
• limit (optional): Maximum number of results (default: 5)

recall_theme_semantic

Recall memories from a theme using semantic/vector search (requires embeddings). Parameters:

• query (required): Search query for semantic search
• theme (optional): Theme name (uses current theme if not specified)
• limit (optional): Maximum number of results (default: 5)

create_entity_theme

Create an entity in a specific theme's database. Parameters:

• name (required): Entity name
• type (optional): Entity type (e.g., 'Person', 'Project', 'Concept')
• observations (optional): Array of initial observations
• theme (optional): Theme name (uses current theme if not specified)

create_relation_theme

Create a relation between two entities in a specific theme's database. Parameters:

• source (required): Source entity name
• target (required): Target entity name
• relation (required): Relation type (e.g., 'works_for', 'knows', 'created')
• theme (optional): Theme name (uses current theme if not specified)

read_graph_theme

Read the knowledge graph from a specific theme's database. Parameters:

• center (optional): Optional entity name to center the graph on
• depth (optional): Traversal depth (default: 1)
• theme (optional): Theme name (uses current theme if not specified)

Usage Example

// Create a new theme for work-related memories
{
  "tool": "create_theme",
  "arguments": {
    "name": "work",
    "description": "Work-related memories and tasks"
  }
}

// Switch to the work theme
{
  "tool": "switch_theme",
  "arguments": {
    "name": "work"
  }
}

// Remember something in the work theme
{
  "tool": "remember_theme",
  "arguments": {
    "text": "Completed the quarterly report",
    "tags": ["work", "completed"]
  }
}

Storage Structure

Themes are stored in ~/.memory/themes/ directory:

~/.memory/themes/
├── .current_theme          # File storing active theme name
├── work/
│   ├── memory.db          # SQLite database for work theme
│   └── metadata.json     # Theme metadata

Notes

• Theme names are sanitized (only alphanumeric, underscore, and hyphen characters allowed)
• Switching themes only affects subsequent operations
• The default theme is 'default' if no theme has been explicitly set
• Each theme has its own isolated SQLite database with the same schema as the main memory database

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Beledarian
• Source: Beledarian/theme-db-extension
• License: MIT
• Homepage: https://github.com/Beledarian/mcp-local-memory

Install and usage instructions live in the source repository linked above.