MCP Server Chat History

A Model Context Protocol server that provides chat history access and search for agentic LLMs and clients.

Features

• list_chats: List recent chats for a user
• get_chat: Fetch full chat by chat_id
• search_chats: Search a user's chats by keyword
• save_message: Append a message to a chat

Quickstart

Install (pip or uv)

pip install mcp-server-chat-history
python -m mcp_server_chat_history

or

uv pip install mcp-server-chat-history
uv run -m mcp_server_chat_history

Docker

docker build -t mcp/chat-history .
docker run -it --rm -p 3000:3000 -v /absolute/path/to/chats:/chats mcp/chat-history

Configuration

Set QODO_CHATLOGS_DIR for your chat logs (default: /chats in Docker, $HOME/all_qodo_chatlogs otherwise):

export QODO_CHATLOGS_DIR=/path/to/your/chatlogs

Usage

After starting the server, connect from your MCP client and call the provided tools.

Available Tools

Tool	Params	Description
list_chats	user_id:str, limit:int=10	List a user’s recent chats
get_chat	chat_id:str	Fetch full chat data
search_chats	user_id:str, query:str	Search for a keyword
save_message	chat_id:str, role:str, message:str	Append a message to a chat

License

MIT

See src/mcp_server_chat_history/main.py for the entrypoint.