# KIAgent

KIAgent — an MCP server that pulls your mail, chats and documents into a local SQLite corpus and feeds the results to AI on demand.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: edjafarov
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/edjafarov/kiagent-core
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/kiagent

## What it 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.

## Requirements
- Remote server: `https://{subdomain}.localkiagent.com/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http kiagent https://{subdomain}.localkiagent.com/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add kiagent --url https://{subdomain}.localkiagent.com/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kiagent": {
            "url": "https://{subdomain}.localkiagent.com/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kiagent": {
            "type": "http",
            "url": "https://{subdomain}.localkiagent.com/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http kiagent https://{subdomain}.localkiagent.com/mcp
```

## When to use it
- 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
- 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?

## Similar
- [mac-code-local-ai-agent](https://affpapa.org/en/nevibecode/skills/mac-code-local-ai-agent.md) — skill · 851 installs
- [skill-ollama-deepseek-ocr-tool](https://affpapa.org/en/nevibecode/skills/skill-ollama-deepseek-ocr-tool.md) — skill · 1 install
- [proactive-mcp](https://affpapa.org/en/nevibecode/mcp/proactive-mcp.md) — MCP server · ★ 12 repo stars
- [Multi-Account Gmail](https://affpapa.org/en/nevibecode/mcp/multi-account-gmail.md) — MCP server · ★ 6 repo stars
- [mirofish-offline-simulation](https://affpapa.org/en/nevibecode/skills/mirofish-offline-simulation.md) — skill · 1400 installs
- [Local Model Suitability MCP](https://affpapa.org/en/nevibecode/mcp/local-model-suitability-mcp.md) — MCP server · 2764 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
