slim-sheet

slim-sheet

小型ローカルモデルでも実際に使えるスプレッドシート MCP サーバーです。 xlsx xlsm xltx xltm xlsb xls ods numbers csv tsv parquet json をローカルで読み込み（Office もネットワークも不要）、すべての応答をトークン予算内に収め、エージェントに SQL、データクリーニング、異常検知、数式コパイロット、Excel の仕様に忠実な編集、1 回の呼び出しで作成できるブランド付きダッシュボードを提供します。モデルの能力に応じて、8、18、または 30 個のツールを利用できます。

Claude Desktop / Claude Code（Free または Pro）、OpenCode、Codex、Cursor、Cline、Continue、LM Studio、Ollama（mcpo または Open WebUI 経由）で動作します。MCP を使わないエージェント向けの通常の CLI としても利用できます。

インストール

uvx slim-sheet mcp                          # MCP server over stdio
uvx slim-sheet overview sales.xlsx          # or use any tool from the shell
uvx --from "slim-sheet[all]" slim-sheet mcp # + offline formula engine, encrypted files, Apple Numbers

すべてのクライアント（Claude、Cursor、OpenCode、Codex、LM Studio、Ollama/mcpo、Open WebUI、Cline、Continue）向けのホスト設定は、docs/hosts.md にあります。

{
  "mcpServers": {
    "slim-sheet": {
      "command": "uvx",
      "args": ["slim-sheet", "mcp"],
      "env": { "SLIM_SHEET_TIER": "lite", "SLIM_SHEET_ROOTS": "/path/to/your/data" }
    }
  }
}

ティア

ティア	ツール	対象
full（デフォルト）	以下のすべてのツール	すべての機能を利用できるモデル
lite	overview、read、find、query、profile、write、explain_formula、build_report	3B～8B のローカルモデル
standard	lite に clean、anomalies（数式監査を含む）、merge、convert（分割を含む）、diff、undo、evaluate（チェックを含む）、describe_cell（トレースを含む）、style_sheet、what_if を追加	中規模モデルおよび最先端モデル
full	standard に create_workbook、sheet_ops、range_ops、name_ops、format_range、set_table、rules、add_chart、sheet_layout、annotate、pivot、split、recalc を追加	ワークブックを作成する最先端モデル

SLIM_SHEET_TOOLS=overview,read,query のように指定して、使用するツールを選べます。

設計：説明をほとんど加えずにプロフェッショナルな出力を実現

モデルは表示する「内容」を指定し、slim-sheet はブランドに基づいて、レイアウト、色、フォント、数値形式、グラフの種類、並べ替え順、インサイトのタイトルなど、「見せ方」を決定します。1 回の呼び出しで：

build_report(path="sales.xlsx", data_sheet="Sales", title="Sales performance 2025",
             kpis=["Revenue=sum:Revenue", "Margin=ratio:Profit/Revenue", "Orders=count"],
             charts=["trend:Month:Revenue", "rank:Region:Revenue", "share:Product:Revenue"])

1 ページのダッシュボードを作成します。ライブ数式を使った KPI タイル（7.1m · 20.4% · 144）、「Revenue rose 58% from 2025-01 to 2025-12」というタイトル付き折れ線グラフ、トップ項目を強調表示した並べ替え済み棒グラフ、ラベル付きドーナツグラフ、ソースのフッターが含まれます。 style_sheet(path, sheet, preset="report") は任意のテーブルに同じスタイルを適用し、推定した数値形式も報告します。

会社のデザインを一度設定するだけです。 組み込みブランドは slim（デフォルト）、office、modern（Aptos）、mono（IBCS 形式）、gov（英国政府統計のスタイル）です。または、SLIM_SHEET_BRAND に JSON ファイルを指定できます。必須なのは name だけです。

{ "name": "Acme", "primary": "#C8102E", "body_font": "Arial", "currency": "$", "profile": "finance" }

以降のすべてのワークブックには、ブランドが実際の Office テーマとして設定されるため、Excel 独自のテーブルスタイルとグラフスタイルにも反映されます。デフォルトの背後にあるルール（IBCS、財務向けの色分け、英国のスプレッドシートアクセシビリティガイダンス、グラフ選択表）については、PLAN.md §16 を参照してください。

独自の特長

• あらゆる形式を読み込み、.xls、.xlsb、.ods、Apple Numbers、パスワード保護された xlsx も、1つのインターフェースで扱えます。
• 出力を予算内に収めます：A1 座標付きの Markdown テーブルを出力し、1回の応答は約1,500トークンです。next カーソルで続きを取得できます。
• 学びにつながるエラー：すべてのエラーにコード、メッセージ、修正済みの呼び出し例が含まれます。
• DuckDB を使ってシートを SQL で検索できます。整理されていないシートは、検出されたヘッダーを基に領域へ分割されます（"Report.2"）。
• データを壊しません：overwrite=true を指定しない限り、編集内容は <name>.slim.xlsx に保存されます。書き込みはアトミックに行われ、置き換えたファイルはすべて記録されます。また、undo で前の状態に戻せます。
• Excel に準拠した構造編集：行の挿入・削除やシート名の変更を行うと、Excel と同じように数式、名前、結合、入力規則、条件付き書式、テーブル、グラフが書き換えられます。
• モデルのチェック：anomalies scope='formulas' で、ハードコードされた数値、パターンの破損、二重計上、エラーの発生箇所を検出できます。describe_cell trace= でシートをまたいで数式を追跡でき、what_if でファイルに触れずに差分分析、ゴールシーク、感度分析グリッドを実行できます。
• 数式コパイロット：514関数のカタログ、バージョンチェック（Excel 2016 の XLOOKUP に対して INDEX/MATCH を提案）、依存関係をたどるオフライン評価を備えています。
• マクロは読み取り専用：read sheet='#vba' で VBA ソースを表示し、anomalies scope='macros' でリスクを評価できます。エージェントはツールを使ってマクロの処理を再現します（プロンプト replace_macro）。slim-sheet はマクロを実行しません。
• Excel と完全に一致する数式：新しい関数は Excel の _xlfn. 接頭辞付きで保存され、スピル数式は実際の動的配列として保存されます。スピルを妨げるものがある場合は警告が表示されます。
• 柔軟なパス指定、安全な初期設定：チャットで任意のフォルダーを指定できます（設定変更は不要です）。システムフォルダー、AppData、.ssh などのドットフォルダー、スプレッドシート以外のファイルは拒否されます。ファイルアクセスを制限した読み取り専用 SQL を使用し、モデルが作成したコードは実行されず、ネットワーク接続もありません。

設定

変数	デフォルト	説明
SLIM_SHEET_TIER	full	full、standard、lite のいずれか
SLIM_SHEET_TOOLS	—	明示的に指定する、カンマ区切りのツール一覧
SLIM_SHEET_ROOTS	現在のディレクトリ	相対パスおよび overview() の既定フォルダー（Windows では ;、それ以外では : で区切ります）
SLIM_SHEET_STRICT_ROOTS	off	1 = SLIM_SHEET_ROOTS 内のパスのみ許可（従来の許可リスト）
SLIM_SHEET_MAX_TOKENS	1500	既定の応答トークン数上限
SLIM_SHEET_TOKEN	—	--transport streamable-http 用のベアラートークン（ループバック以外では必須）
SLIM_SHEET_PASSWORD	—	暗号化されたワークブックのパスワード（チャット経由で渡されることはありません）
SLIM_SHEET_SOFFICE	自動検出	recalc 用の LibreOffice バイナリ
SLIM_SHEET_AUDIT_LOG	—	すべてのツール呼び出しを記録する JSONL 監査ログ（内容は伏せられます）
SLIM_SHEET_RATE_LIMIT	120	クライアントごとの HTTP ツール呼び出し数（1分あたり。0 = 無効）
SLIM_SHEET_MAX_CELLS	3000000	宣言されたセル数がこれを超えるワークブックは拒否します（0 = 無効）
SLIM_SHEET_BRAND	slim	ブランド名（slim、office、modern、mono、gov）またはブランドの .json へのパス

追加機能：formula（オフラインの evaluate と what_if）、crypto（暗号化 xlsx）、numbers（Apple Numbers）、images（annotate で画像を挿入）、all。

プロンプトライブラリ

すぐに使える、データに依存しないプロンプトです。共通の CORE メソッド、13種類の ROLES（アナリスト向けの9種類の役割：営業、財務、マーケティング、顧客、運用、人事、照合、データ品質、汎用。さらにモデル監査担当、ワークブック編集者、マクロ移行担当、ファイルレビュー担当）と、8種類の OUTPUT パターン（ダッシュボード、ダッシュボードパック、レポートワークブック、クリーンなデータセット、照合レポート、簡易回答、監査レポート、編集済みワークブック）を備えています。 記入済みのサンプルセット、8つのパック（財務、営業、人事、運用、データ準備、Excel タスク、レポート作成、ベトナム）に収録された約50種類のワンペースト式タスクレシピ、小規模なローカルモデル向けのコンパクトなブロックも用意されています： docs/prompts。

スキルパック

skills/building-client-reports を使うと、ツールをクライアント向けのレポートに仕上げられます。レポートの概要、役割別のプリセット（CFO、取締役会、営業、マーケティング、オペレーション、人事、市場調査）、標準チェックリスト、評価が含まれます。~/.claude/skills/ にコピーするか、任意のエージェントに添付してください（skills/README.md）。

MCP 以外のホスト

slim-sheet schema --format openai --tier lite      # function-calling schemas for any OpenAI-compatible API
slim-sheet schema --format anthropic --tier full   # Messages API tool definitions
SLIM_SHEET_TOKEN=... slim-sheet mcp --transport streamable-http --host 0.0.0.0 --port 8765

開発

uv sync --all-extras
uv run pre-commit install                 # ruff, mypy, manifests, commit-message rule, tests on push
uv run python scripts/make_demo.py        # sample workbooks in ~/Documents/slim-sheet-demo
uv run ruff check . && uv run ruff format --check . && uv run mypy src && uv run pytest -q

Issue とプルリクエストには .github/ のテンプレートを使用してください。セキュリティに関する報告は SECURITY.md からお送りください。

設計とロードマップ：PLAN.md · エージェントのルール： AGENTS.md · MIT ライセンス。