# MCP-Excel

The MCP-Excel MCP server for Claude Code turns Google Sheets into a CRM for leads, organizations, contacts, and activities. Agents can manage records and inspect lead pipeline data.

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

## What it does

MCP-Excel exposes Google Sheets CRM operations to an MCP client. It creates four tabs for leads, organizations, contacts, and activities when a sheet is first connected, then adds missing columns while keeping existing data. Each tool call needs a `sheet_id`, supplied as a spreadsheet URL or ID.

The server runs over HTTP or `stdio`. Its tools add, search, filter, update, and soft-delete records; find related entries; and report lead pipeline totals and breakdowns. Column matching handles synonyms, and `tool_dedupe_headers` can report and merge duplicate headers.

Setup requires the Python packages in `requirements.txt` and a Google service-account key. Enable Google Sheets API and Google Drive API, then share each spreadsheet with that account as an Editor. Business-card extraction also needs `anthropic` and `ANTHROPIC_API_KEY`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- store CRM records in Google Sheets
- search records across spreadsheet columns
- change a record using its primary-key ID
- retrieve activities linked to a lead
- merge duplicate spreadsheet headers

## Example prompts
- Add a lead to the sheet with `sheet_id` `SHEET_ID` and set its organization and status.
- Find contacts by email in the spreadsheet with `sheet_id` `SHEET_ID`.
- Show lead pipeline analytics for the sheet with `sheet_id` `SHEET_ID`.

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4321 repo stars
- [excel-vision-mcp](https://affpapa.org/en/nevibecode/mcp/excel-vision-mcp.md) — MCP server · ★ 20 repo stars
- [Google Sheets](https://affpapa.org/en/nevibecode/mcp/google-sheets.md) — MCP server · 56138 installs
- [datatomcp](https://affpapa.org/en/nevibecode/mcp/datatomcp.md) — MCP server
- [gws-sheets](https://affpapa.org/en/nevibecode/skills/gws-sheets.md) — skill · 61900 installs
- [gws-sheets-read](https://affpapa.org/en/nevibecode/skills/gws-sheets-read.md) — skill · 52800 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
