@contextable/mcp

@contextable/mcp

Give your AI a memory. Works with Claude Desktop and any MCP-compatible client.

Quick Start (30 seconds)

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "contextable": {
      "command": "npx",
      "args": ["@contextable/mcp"]
    }
  }
}

Restart Claude Desktop. Done.

Now ask Claude: "Create a project called My App to track my development decisions"

What You Can Do

Save context that persists across conversations:

• "Save this architecture decision to the project"
• "Remember this API design for later"
• "Store this bug investigation so I don't forget"

Find anything instantly:

• "Search for authentication"
• "What did we decide about the database?"
• "Load all security-related artifacts"

Pick up where you left off:

• "Resume my project"
• "Show me the project summary"
• "What were we working on?"

Import your chat history (NEW):

• "Analyze my ChatGPT export at ~/Downloads/chatgpt-export.zip"
• "Import the 'React Development' project from my chat history"
• "What projects can you detect from my Claude conversations?"

Features

Feature	Description
Projects	Organize context by project or topic
Artifacts	Save decisions, code snippets, docs, conversations
Full-Text Search	Find anything across all projects
Version History	Every change tracked, rollback anytime
Auto-Chunking	Large content automatically split
Topic Clustering	Auto-detect themes across artifacts
Chat Import	Import from ChatGPT, Claude, Gemini exports

All 15 Tools

Projects

• project_save - Create or update a project
• project_list - List all projects
• project_resume - Load project with summaries
• project_analysis_get - Get AI-generated insights

Artifacts

• artifact_save - Save content (auto-chunks large files)
• artifact_list - List with size estimates
• artifact_get - Load full content
• artifact_delete - Archive (recoverable)
• artifact_restore - Restore archived
• artifact_archived - List archived items
• artifact_versions - View history
• artifact_rollback - Restore previous version

Search

• search - Full-text search across everything

Import (NEW in v0.2.0)

• import_analyze - Analyze chat exports from ChatGPT, Claude, or Gemini
• import_seed - Create projects from analyzed chat history

Your Data

Everything is stored locally in SQLite:

~/.contextable/data.db

No account. No cloud. No tracking. Your data stays on your machine.

---

Want More?

Contextable Cloud adds:

Feature	Local	Cloud
Claude Desktop	✓	✓
ChatGPT	-	✓
Claude.ai (web)	-	✓
Sync across devices	-	✓
AI analysis & insights	-	✓
Team sharing	-	Coming soon

Try Contextable Cloud →

---

Configuration

Environment Variables

Variable	Default	Description
CONTEXTABLE_DATA_DIR	~/.contextable	Data directory
CONTEXTABLE_DB_PATH	~/.contextable/data.db	SQLite database path
CONTEXTABLE_LOG_LEVEL	info	Logging: debug, info, warn, error

Custom Database Location

{
  "mcpServers": {
    "contextable": {
      "command": "npx",
      "args": ["@contextable/mcp"],
      "env": {
        "CONTEXTABLE_DB_PATH": "/path/to/my/data.db"
      }
    }
  }
}

HTTP Mode (Advanced)

For web-based MCP clients, run as HTTP server:

npx @contextable/mcp --sse --port 3000

Endpoints:

• GET /health - Health check
• POST /mcp - MCP messages (JSON-RPC)

Programmatic Usage

import { SQLiteAdapter } from '@contextable/mcp';

const storage = new SQLiteAdapter({ path: './my-context.db' });
await storage.initialize();

// Create a project
const project = await storage.createProject({
  name: 'My Project',
  description: 'Project description',
});

// Save an artifact
const artifact = await storage.createArtifact({
  projectId: project.id,
  title: 'Design Decision',
  artifactType: 'decision',
  content: '# We chose PostgreSQL because...',
});

// Search
const results = await storage.search('postgresql');

await storage.close();

Development

git clone https://github.com/Contextable-me/mcp.git
cd mcp
npm install
npm run build
npm test

License

Apache 2.0 - See LICENSE

Links

• Contextable Cloud - Sync, ChatGPT, AI analysis
• GitHub - Source code
• MCP Protocol - Specification
• npm - Package