Skip to main content
Glama

mcp-excel

MCP server untuk baca file Excel (.xlsx, .xls). Gratis, open source, tanpa API key.

Features

  • Baca file Excel (.xlsx, .xls)

  • Tampilkan jumlah baris & kolom

  • Tampilkan nama-nama kolom

  • Tampilkan 5 baris pertama sebagai preview

  • Error handling yang clean

Related MCP server: Excel Explorer

Install

git clone https://github.com/username/mcp-excel-reader.git
cd mcp-excel-reader
npm install
npm run build

Usage

Jalankan Server

npm start

Test dengan MCP Inspector

npx @modelcontextprotocol/inspector

Buka browser ke http://localhost:6274, lalu connect:

  • Command: node

  • Arguments: dist/server.js

  • Working Directory: /path/to/mcp-excel-gratis

Konfigurasi di Claude Desktop

Tambahkan di claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-excel-gratis": {
      "command": "node",
      "args": ["/path/to/mcp-excel-gratis/dist/server.js"]
    }
  }
}

Tool: read_excel

Input:

Parameter

Type

Description

filePath

string

Path lengkap ke file Excel

Output:

{
  "filePath": "/path/to/file.xlsx",
  "sheetName": "Sheet1",
  "rowCount": 100,
  "columnCount": 5,
  "columnNames": ["Name", "Email", "Phone", "City", "Value"],
  "firstFiveRows": [
    {
      "Name": "John Doe",
      "Email": "john@example.com",
      "Phone": "08123456789",
      "City": "Jakarta",
      "Value": 1500000
    }
  ]
}

Demo

The MCP server successfully reads Excel workbook data through the read_excel tool.

MCP Excel Reader Demo

Demo

Tech Stack

License

MIT

Available Tools

1 tool
read_excelD
NameRequiredDescriptionDefault
filePathYesAbsolute path to the Excel file (.xlsx, .xls)

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedread_excel

TDQS

D1.8/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no potential for confusion between tools. The name 'read_excel' clearly indicates its purpose, making it unambiguous.

Naming Consistency5/5

The single tool follows a clear verb_noun naming pattern (read_excel), and there are no other tools to introduce inconsistency.

Tool Count2/5

Having only one tool is too few for an Excel reader, which typically needs operations like listing sheets, reading specific ranges, or fetching metadata. This feels thin for the server's stated purpose.

Completeness2/5

The server only offers a single 'read_excel' operation, leaving gaps for specifying sheets, ranges, or handling different data formats. This is a significant limitation for a comprehensive Excel reading experience.

Maintenance

ActivityStale
ResponsivenessSyncing

Related MCP Connectors

  • The Excel engine for AI agents: read, check and edit Excel models over MCP.

    https://api.basis1.tech/mcp
  • Convert Apple Numbers (.numbers) to Excel (.xlsx) in the browser — first sheet free. MCP v1.1.0 (Streamable HTTP) exposes four tools: open_numbers2excel (open site / Stripe checkout intents; conversion is browser-local), get_site_info (product overview, pricing, URLs; read-only), get_pro_status (Stripe subscription_id sub_… status), get_unlock_from_session (Checkout session_id cs_… → entitlement). Path A: MCP does not accept or upload files.

    https://numbers2excel.com/mcp
  • ParseHub.dev is a hosted document-to-records service with a remote MCP server. Agents can upload a CSV, PDF, or Word file, summarize and analyze CSV data (filter, sort, group_by, and more), read text from PDF and Word files, extract attendees, agenda items, and action items from meeting notes, ask a question about an uploaded document, and store files as database records to list and read later. Each account sees only its own files and records. **Endpoint:** `https://parsehub.dev/mcp` (Streamable HTTP, stateless) **Auth:** API key in the `X-API-Key` header (keys start with `mcp_`), or `Authorization: Bearer <API key or JWT>`. Every request without credentials returns 401. **Plans:** Free (100 API requests/month, 1 document upload), or 5,000 requests/month on the $9/month or $42/year plan. Every MCP request counts toward the allowance. **Tools:** upload_csv, summarize_csv, analyze_csv, upload_document, read_document, extract_meeting_notes, ask_document, database_status, list_database_documents, get_database_document, store_document, extract_stored_meeting_notes, export_database (administrators only). Not affiliated with ParseHub (parsehub.com), the web-scraping tool. ParseHub.dev does not scrape websites. By Poietes LLC. Docs: https://parsehub.dev/guide#connect-via-mcp

    https://parsehub.dev/mcp
  • Query, join, profile, clean and convert CSV/JSON/Parquet with server-side DuckDB over MCP.

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides tools for reading Excel (xlsx) files, enabling extraction of data from entire workbooks or specific sheets with results returned in structured JSON format.
    3
    6
    Apache 2.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables reading and searching Excel files through MCP-compatible clients. Provides tools to retrieve workbook metadata, read sheet contents, and search across all sheets using absolute file paths.
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    MCP server for reading and writing Excel (xlsx) files using SheetJS, providing tools to list sheets, read data, create files, add sheets, and update cells.
    5
    11 npm
    MIT