KIAgent — Claude Code MCP server: what it does, how to install
KIAgent — an MCP server that pulls your mail, chats and documents into a local SQLite corpus and feeds the results to AI on demand.
MIT ★ 7 updated 2026-10-23
Open on GitHubWhat KIAgent does
KIAgent pulls messages from Gmail, IMAP and Microsoft 365, picks up files from local folders, and lands them in a SQLite database on your disk. Parsing, OCR and embedding run through a bundled llama.cpp instance, so nothing leaves the machine. The assistant queries the server over HTTP or stdio and retrieves the chunks it needs.
A plugin system gives data sources controlled access to web requests, the local model and the filesystem. Marketplace plugins run in isolated host processes.
First-time setup involves configuring OAuth for mail sources and pointing the app at folder paths. OCR for scanned documents and images will not run if the llama.cpp server is unavailable.
What it helps with
- index mail and documents locally without sending them to the cloud
- give the agent context from past correspondence and project files
- extract text from scans and images without external APIs
- bring in a new data source via a marketplace plugin
Example prompts for the agent
- Find all mail from {name} in the last month mentioning budget
- Show documents in
~/projects/client-xthat reference database migration - Is there anything in the index about setting up OAuth for Microsoft 365?
How to install KIAgent
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http kiagent https://{subdomain}.localkiagent.com/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add kiagent --url https://{subdomain}.localkiagent.com/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"kiagent": {
"url": "https://{subdomain}.localkiagent.com/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"kiagent": {
"type": "http",
"url": "https://{subdomain}.localkiagent.com/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http kiagent https://{subdomain}.localkiagent.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about KIAgent
How to install KIAgent in Claude Code?
Run claude mcp add --transport http kiagent https://{subdomain}.localkiagent.com/mcp, replacing {subdomain} with your local server address.
What does KIAgent do?
It collects mail, documents and files into a local database, indexes their content, and serves it to the assistant over MCP. Everything stays on your machine.
Which data sources does KIAgent support?
Gmail, IMAP, Microsoft 365 and local folders are built in. Additional sources install as marketplace plugins.