Skip to main content
Glama
Excel MCP Server
by negokaz

Excel MCP 서버

NPM 버전 대장간 배지

MS Excel 데이터를 읽고 쓰는 MCP(Model Context Protocol) 서버입니다.

특징

  • 텍스트 값 읽기/쓰기

  • 수식 읽기/쓰기

  • 새 시트 만들기

🪟Windows 전용:

  • 라이브 편집

  • 시트에서 화면 이미지 캡처

자세한 내용은 도구 섹션을 참조하세요.

Related MCP server: MCP Sheet Parser

요구 사항

  • Node.js 20.x 이상

지원되는 파일 형식

  • xlsx(엑셀 책)

  • xlsm(Excel 매크로 사용 책)

  • xltx(Excel 템플릿)

  • xltm(Excel 매크로 사용 템플릿)

설치

NPM을 통해 설치

excel-mcp-server는 다음 구성을 MCP 서버 구성에 추가하여 자동으로 설치됩니다.

Windows의 경우:

지엑스피1

다른 플랫폼의 경우:

{
    "mcpServers": {
        "excel": {
            "command": "npx",
            "args": ["--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Excel MCP Server를 자동으로 설치하려면:

npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude

excel_describe_sheets

지정된 Excel 파일의 모든 시트 정보를 나열합니다.

인수:

  • fileAbsolutePath

    • Excel 파일의 절대 경로

excel_read_sheet

페이지 번호를 매겨 Excel 시트에서 값을 읽습니다.

인수:

  • fileAbsolutePath

    • Excel 파일의 절대 경로

  • sheetName

    • Excel 파일의 시트 이름

  • range

    • Excel 시트에서 읽을 셀 범위(예: "A1:C10"). [기본값: 첫 번째 페이지 범위]

  • knownPagingRanges

    • 이미 읽은 페이징 범위 목록

  • showFormula

    • 값 대신 수식을 표시합니다.

excel_screen_capture

[Windows 전용] 페이지 번호가 매겨진 Excel 시트의 스크린샷을 찍습니다.

인수:

  • fileAbsolutePath

    • Excel 파일의 절대 경로

  • sheetName

    • Excel 파일의 시트 이름

  • range

    • Excel 시트에서 읽을 셀 범위(예: "A1:C10"). [기본값: 첫 번째 페이지 범위]

  • knownPagingRanges

    • 이미 읽은 페이징 범위 목록

excel_write_to_sheet

Excel 시트에 값을 씁니다.

인수:

  • fileAbsolutePath

    • Excel 파일의 절대 경로

  • sheetName

    • Excel 파일의 시트 이름

  • newSheet

    • true이면 새 시트를 만들고, 그렇지 않으면 기존 시트에 씁니다.

  • range

    • Excel 시트에서 읽을 셀 범위(예: "A1:C10").

  • values

    • Excel 시트에 쓸 값입니다. 값이 수식인 경우 "="로 시작해야 합니다.

excel_create_table

Excel 시트에 표 만들기

인수:

  • fileAbsolutePath

    • Excel 파일의 절대 경로

  • sheetName

    • 테이블이 생성된 시트 이름

  • range

    • 범위가 테이블이 되도록 합니다(예: "A1:C10")

  • tableName

    • 생성할 테이블 이름

excel_copy_sheet

기존 시트를 새 시트로 복사

인수:

  • fileAbsolutePath

    • Excel 파일의 절대 경로

  • srcSheetName

    • Excel 파일의 소스 시트 이름

  • dstSheetName

    • 복사할 시트 이름

다음 환경 변수를 사용하여 MCP 서버 동작을 변경할 수 있습니다.

EXCEL_MCP_PAGING_CELLS_LIMIT

단일 페이징 작업에서 읽을 수 있는 셀의 최대 수입니다.
[기본값: 4000]

특허

Copyright (c) 2025 네고로 카즈키

excel-mcp-server는 MIT 라이선스 에 따라 출시됩니다.

Available Tools

6 tools
excel_copy_sheetB
Destructive

Copy existing sheet to a new sheet

Inputs: dstSheetName (required), fileAbsolutePath (required), srcSheetName (required).

excel_create_tableA
Destructive

Create a table in the Excel sheet

Inputs: fileAbsolutePath (required), sheetName (required), tableName (required), range.

excel_describe_sheetsB
Destructive

List all sheet information of specified Excel file

Inputs: fileAbsolutePath (required).

excel_format_rangeB
Destructive

Format cells in the Excel sheet with style information

Inputs: fileAbsolutePath (required), range (required), sheetName (required), styles (required).

excel_read_sheetB
Destructive

Read values from Excel sheet with pagination.

Inputs: fileAbsolutePath (required), sheetName (required), range, showFormula, +1 more.

excel_write_to_sheetC
Destructive

Write values to the Excel sheet

Inputs: fileAbsolutePath (required), newSheet (required), range (required), sheetName (required), +1 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific Excel operations: copying sheets, creating tables, describing sheets, formatting ranges, reading data, and writing data. There is no overlap or ambiguity between these functions, making tool selection straightforward for an agent.

    Naming Consistency5/5

    All tool names follow a consistent 'excel_verb_noun' pattern (e.g., excel_copy_sheet, excel_create_table), using snake_case throughout. This predictable naming convention enhances readability and reduces cognitive load for agents.

    Tool Count4/5

    With 6 tools, the server is well-scoped for basic Excel operations, covering key tasks like reading, writing, formatting, and sheet management. It could benefit from additional tools for advanced features (e.g., formulas, charts), but the current set is reasonable and focused.

    Completeness4/5

    The tools provide solid coverage for core Excel workflows: reading and writing data, sheet management, formatting, and table creation. Minor gaps exist, such as lacking tools for formulas, charts, or cell manipulation (e.g., delete, merge), but agents can handle common tasks effectively with this surface.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server designed for AI assistants to directly process spreadsheet files, enabling them to read, display, modify, and save various table formats like CSV and Excel.
      3
      3
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI agents to freely operate Excel spreadsheets, providing tools for workbook creation, cell manipulation, formatting, formula handling, and data export.
      11
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to automate Microsoft Excel tasks such as reading/writing cells, formatting, creating charts, and managing sheets through natural language using the Model Context Protocol.
      1
      Apache 2.0