Skip to main content

MCP server to give client the ability to read Excel files

Project description

mcp-excel

MCP server to give client the ability to read Excel files

Usage

For this MCP server to work, add the following configuration to your MCP config file:

{
  "mcpServers": {
    "excel": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "-m",
        "mcp_excel"
      ]
    }
  }
}

Features

  • Read Excel files and get their content as pandas DataFrames
  • Extract Excel properties including:
    • Data validation rules
    • Dropdown lists
    • Merged cells
    • Hidden rows and columns
  • Comprehensive error handling
  • Full test coverage

Requirements

  • Python >= 3.12
  • pandas >= 2.2.3
  • openpyxl >= 3.1.5
  • mcp[cli] >= 1.3.0

Development

  1. Clone the repository
  2. Install development dependencies:
    pip install -e ".[dev]"
    
  3. Run tests:
    pytest
    

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_excel-0.1.2.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_excel-0.1.2-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file mcp_excel-0.1.2.tar.gz.

File metadata

  • Download URL: mcp_excel-0.1.2.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.1

File hashes

Hashes for mcp_excel-0.1.2.tar.gz
Algorithm Hash digest
SHA256 1a8da17d331efbcf6d880659e5440b969e01b7d86f79f498db8277785b5d19a6
MD5 a287c547abd8ca18a9e1333454e004fa
BLAKE2b-256 98014086f353817a5a81dba132f186597094938bbf9d37a2aa2f34b29c2b12da

See more details on using hashes here.

File details

Details for the file mcp_excel-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: mcp_excel-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 4.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.1

File hashes

Hashes for mcp_excel-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 685f224f9729a685b43cd5c63ed8546675091ced8afc9e2a5aab2a429d778036
MD5 775713a966619efb0ac8dbffd2b0a252
BLAKE2b-256 493d3fab9fe45382fef0a6f60427dca5a4a865d4366b66e5186143b843c7faee

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page