{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_f8mx88fsg28u","handle":"q-mem-mcp-server","url":"https://wellknown.network/agents/q-mem-mcp-server","links":{"self":"https://wellknown.network/agents/q-mem-mcp-server/record.json","html":"https://wellknown.network/agents/q-mem-mcp-server","markdown":"https://wellknown.network/agents/q-mem-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/q-mem-mcp-server","status":"https://wellknown.network/api/v1/agents/q-mem-mcp-server/status","claim":"https://wellknown.network/agents/q-mem-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/q-mem-mcp-server/claim.json","badge":"https://wellknown.network/agents/q-mem-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:q-mem-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"q-mem-mcp-server","summary":"Conversation memory and workspace management MCP server for Amazon Q CLI with SQLite + FTS5 storage and real-time sync","description":"# Q Memory MCP Server\n\nA Model Context Protocol (MCP) server that provides conversation memory and workspace management for Amazon Q CLI using SQLite + FTS5 for fast, reliable storage and search.\n\n## Features\n\n- **Automatic Conversation Saving**: Real-time sync of Q CLI conversations to SQLite database\n- **Workspace Management**: Organize conversations by topics/workspaces with natural language support\n- **Workspace Restoration**: Resume previous conversations with full context\n- **Full-Text Search**: Search through conversation history using SQLite FTS5\n- **Q CLI LLM Integration**: Intelligent conversation summarization using Q CLI's built-in LLM\n\n## Quick Start\n\n### 1. MCP Configuration\nAdd to `~/.aws/amazonq/mcp.json`:\n\n**For macOS:**\n```json\n{\n  \"mcpServers\": {\n    \"q-mem\": {\n      \"command\": \"uvx\",\n      \"args\": [\"q_mem_mcp_server@latest\"],\n      \"env\": {\n        \"Q_CLI_DB_PATH\": \"~/Library/Application Support/amazon-q/data.sqlite3\",\n        \"Q_MEM_VERBOSE\": \"true\"\n      },\n      \"disabled\": false \n    }\n  }\n}\n```\n\n**For Windows:**\nFirst, find your Q CLI database path:\n```cmd\nwhere /r %USERPROFILE% data.sqlite3\n```\n\nThen use the found path in your configuration:\n```json\n{\n  \"mcpServers\": {\n    \"q-mem\": {\n      \"command\": \"uvx\",\n      \"args\": [\"q_mem_mcp_server@latest\"],\n      \"env\": {\n        \"Q_CLI_DB_PATH\": \"C:\\\\Users\\\\YourUsername\\\\AppData\\\\Local\\\\amazon-q\\\\data.sqlite3\",\n        \"Q_MEM_VERBOSE\": \"true\"\n      },\n      \"disabled\": false \n    }\n  }\n}\n```\n\n### 2. Usage Examples\n```bash\n# Start Q CLI\nq chat\n\n# Start a new workspace\nstart_workspace(description=\"backend_development\")\n# OR natural language: \"Start backend development workspace\"\n\n# Chat normally (automatically saved)\n# ... have conversations ...\n\n# List workspaces\nlist_workspaces()\n\n# Resume workspace (loads full context)\nresume_workspace(workspace_id=\"backend_development\")\n# OR natural language: \"Resume backend development workspace\"\n\n# Switch to another workspace\nresume_workspace(workspace_id=\"fr…","publisher":null,"homepage":"https://github.com/jikjeong/q-mem-mcp-server/blob/main/README.md","repository":"https://github.com/jikjeong/q-mem-mcp-server/blob/main/README.md","version":"2.2.4","license":"MIT","protocols":["mcp"],"tags":["amazon-q","conversation-memory","fts5","mcp","real-time-sync","sqlite","workspace-management"],"pricing":null,"endpoints":[{"url":"pypi:q-mem-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":1,"provenance":"derived"},{"slug":"knowledge.memory","name":"Agent Memory","confidence":1,"provenance":"derived"}],"categories":["commerce","data","knowledge"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"q-mem-mcp-server","registry":"pypi","observedAt":"2026-09-10T10:25:56.970Z","publishedAt":"2025-07-12T11:47:43.017601Z","latestVersion":"2.2.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"q-mem-mcp-server","url":"https://pypi.org/project/q-mem-mcp-server/","firstSeenAt":"2026-09-10T10:25:03.214Z","fetchedAt":"2026-09-10T10:25:03.214Z","normalizedAt":"2026-09-10T10:25:03.214Z"}]},"firstSeenAt":"2026-09-10T10:25:03.214Z","updatedAt":"2026-09-10T10:25:56.970Z"}