Skip to main content
MCP server CX Codex

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 GitHub

What 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-x that 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/mcp

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open