# MCP Servers — Configuration Reference

MCP (Model Context Protocol) servers extend Claude Code with external tool
capabilities. Each server runs as a child process and exposes tools that
Claude can call.

**Config file:** `.mcp.json` in repo root (shared across machines via git).

---

## Active Servers

### TickTick

Task management integration for TickTick (todo/project tracking app).

**Tools provided:**
- `ticktick_create_task`, `ticktick_update_task`, `ticktick_complete_task`, `ticktick_delete_task`
- `ticktick_create_project`, `ticktick_update_project`, `ticktick_delete_project`
- `ticktick_list_projects`, `ticktick_get_project`

**Auth:** OAuth token stored in vault at `services/ticktick.sops.yaml`. Token file
auto-generated by `mcp-servers/ticktick/ticktick_auth.py` on first use.

**Config in `.mcp.json`:**
```json
{
  "mcpServers": {
    "ticktick": {
      "command": "python",
      "args": ["D:\\claudetools\\mcp-servers\\ticktick\\ticktick_mcp.py"]
    }
  }
}
```

### Claude-in-Chrome (browser automation)

Installed as a Chrome browser extension. Provides browser automation tools
for web interaction, form filling, page reading, screenshots, GIF recording.

**Not configured in `.mcp.json`** — runs as a Chrome extension that connects
automatically when the Claude Code extension is active and Chrome is open.

**Tools provided:** `tabs_context_mcp`, `tabs_create_mcp`, `navigate`, `computer`
(click/type/screenshot), `read_page`, `find`, `form_input`, `javascript_tool`,
`get_page_text`, `read_console_messages`, `gif_creator`, etc.

**Requires:** Chrome browser with the Claude-in-Chrome extension installed.

---

## Available but Not Wired

These server directories exist but aren't in `.mcp.json`. Add them when needed.

### GrepAI MCP Server

Semantic code search over the indexed codebase. Alternative to using the
`grepai search` CLI directly.

**To activate:** Add to `.mcp.json`:
```json
{
  "grepai": {
    "command": "D:\\claudetools\\grepai.exe",
    "args": ["mcp-serve"]
  }
}
```

**Requires:** GrepAI initialized (`grepai init`) + Ollama running with
`nomic-embed-text` model. Index builds automatically via `grepai watch`.

### Ollama Assistant

Local LLM integration for delegating simple tasks (summarization,
classification, drafting) to locally-running models.

**Location:** `mcp-servers/ollama-assistant/`

**To activate:** Check the server's README for the exact `.mcp.json` entry.
Requires Ollama running at `http://localhost:11434` with models pulled.

### Feature Management

Feature flag management server.

**Location:** `mcp-servers/feature-management/`

**Status:** Exists but purpose unclear. Check directory for README.

---

## Adding a New MCP Server

1. Create directory: `mcp-servers/<name>/`
2. Write the server script (Python or Node recommended)
3. Add entry to `.mcp.json` with `command` and `args`
4. Restart Claude Code to pick up the new server
5. Document in this file

**Important:** `.mcp.json` is tracked in git. Changes sync to all machines.
Machine-specific server paths should use absolute paths that work on all
team workstations (or use relative paths from repo root).

---

*Last updated: 2026-04-16*
