SparkSheets MCP Server

MCP server for SparkSheets - AI-powered document platform integration for Claude Code, Cursor, and Cline.

日本語 | English

Installation

npm install -g @sparksheets/mcp

Quick Setup

Add to your ~/.claude.json:

{
  "mcpServers": {
    "sparksheets": {
      "command": "sparksheets-mcp"
    }
  }
}

Then login with your SparkSheets account:

sparksheets_login

Features

• Session Management - Save and search development session history

• Knowledge Base - Store error solutions and code snippets

• Usage Tracking - Sync /stats output and work time

• Sheet Operations - Create, edit, search sheets from CLI

• Spark Integration - Run AI features from terminal

Available Tools (37 tools)

Documentation

• User Guide: https://sparksheets.ai/docs/guide/mcp/

• SparkSheets: https://sparksheets.ai/

License

MIT

日本語ドキュメント

Claude Code開発者のためのダッシュボード。セッション履歴、ナレッジベース、使用量統計、タスク管理をSparkSheetsで一元管理。

📋 概要

このMCPサーバーは、Claude CodeとSparkSheetsを統合し、以下を実現します：

• セッション管理: 開発セッションの履歴保存・検索

• ナレッジベース: エラー解決策とコードスニペットの蓄積

• 使用量追跡: /stats出力の自動保存・可視化

• タスク管理: TodoWriteの進捗同期

• シート操作: SparkSheets CRUD操作

• Spark連携: AIボタン機能のCLI実行

🛠️ インストール

npm（推奨）

npm install -g @sparksheets/mcp

~/.claude.json に追加：

{
  "mcpServers": {
    "sparksheets": {
      "command": "sparksheets-mcp"
    }
  }
}

手動インストール

git clone https://github.com/sparksheets/mcp.git ~/.claude/mcp-servers/mcp-sparksheets
cd ~/.claude/mcp-servers/mcp-sparksheets
npm install

~/.claude.json に追加：

{
  "mcpServers": {
    "sparksheets": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/.claude/mcp-servers/mcp-sparksheets/server.js"]
    }
  }
}

🔧 初回認証

Claude Codeで以下を実行：

sparksheets_login

または自然言語で：

「SparkSheetsにログインして」

ブラウザが開き、Googleアカウントで認証後、自動的にトークンが保存されます。

トークン保存場所: ~/.sparksheets/tokens.json

🛠️ 実装ツール一覧（37ツール）

認証（3ツール）

• sparksheets_login - SparkSheetsにログインします。ブラウザが開き、Googleアカウントで認証後、自動的にトークンが保存されます。

• sparksheets_logout - SparkSheetsからログアウトします。保存されたトークンを削除します。

• sparksheets_auth_status - 現在の認証状態を確認します。ログイン中のユーザー情報やトークンの有効期限を表示します。

セッション管理（4ツール）

• save_session - 現在のセッション要約をSparkSheetsに保存

• list_sessions - 全セッション一覧を取得

• search_sessions - キーワードでセッション検索

• create_handover - 引き継ぎシート自動生成（次にやること、注意点などをまとめる）

ナレッジベース（4ツール）

• save_solution - エラー解決策を辞典に保存

• find_solution - 過去の解決策を検索

• save_snippet - コードスニペットを保存

• get_snippet - スニペットを取得・検索

シート操作（11ツール）

• upload_image - 画像をSparkSheetsにアップロード。Base64またはファイルパスを指定。戻り値にMarkdown形式の画像タグを含む

• append_to_sheet - シートの指定カラムの末尾にコンテンツを追記

• list_sheets - シート一覧取得

• create_sheet - 新規シート作成

• update_sheet - シート編集

• get_sheet_content - シート内容取得（オプションでコンテキスト制御可能）

• search_sheets - シート検索

• delete_sheet - シート削除

• add_column - シートにカラムを追加（最大3カラムまで）

• remove_column - シートからカラムを削除

• get_column_info - シートのカラム情報を取得

統計・作業時間（3ツール）

• sync_stats - /statsの内容をSparkSheetsに同期

• log_work_time - 作業時間を記録

• get_usage_dashboard - 使用量ダッシュボードURL取得

タスク管理（2ツール）

• sync_todos - TodoWriteの内容をSparkSheetsに同期

• get_review_queue - PRレビューキュー取得（GitHub連携）

Spark連携（3ツール）

• run_spark - Spark（AIボタン）をCLIから実行

• list_sparks - 利用可能なSpark一覧

• translate_sheet - シートを多言語翻訳

共有・メンバー管理（7ツール）

• create_share_link - シートの共有リンクを発行。既存のアクティブな共有がある場合は再利用される

• get_share_settings - シートの現在の共有設定を取得

• disable_share - 共有リンクを無効化

• list_members - シートのメンバー一覧を取得

• add_member - シートにメンバーを追加（招待）。オーナーのみ実行可能

• update_member_role - メンバーの権限を変更。オーナーのみ実行可能

• remove_member - シートからメンバーを削除。オーナーのみ実行可能

📝 使用例

セッション保存

「今日の作業をSparkSheetsに保存して」
→ save_session ツールが実行される
→ https://sparksheets.ai/sheet/xxx に保存

エラー辞典

「このCORSエラーの解決策、保存しておいて」
→ save_solution ツールが実行

「CORSエラーの直し方、前に保存したやつ見せて」
→ find_solution("CORS") で検索

引き継ぎシート

「引き継ぎシート作って」
→ create_handover ツールが実行
→ 次にやること、注意点、関連ファイルがまとまったシート生成

統計同期

「/statsの結果をSparkSheetsに保存して」
→ sync_stats ツールが実行
→ グラフ化されたダッシュボードで確認可能

🗂️ ファイル構成

~/.claude/mcp-servers/mcp-sparksheets/
├── server.js              # MCPサーバー本体
├── package.json
├── README.md              # このファイル
├── tools/
│   ├── auth.js            # 認証ツール
│   ├── sessions.js        # セッション管理ツール
│   ├── knowledge.js       # ナレッジベースツール
│   ├── stats.js           # 統計ツール
│   ├── tasks.js           # タスク管理ツール
│   ├── sheets.js          # シート操作ツール
│   └── spark.js           # Spark連携ツール
├── lib/
│   ├── api-client.js      # SparkSheets API ラッパー
│   └── storage.js         # ローカルJSON保存
└── logs/
    ├── sessions.json      # セッション履歴
    ├── solutions.json     # エラー辞典
    ├── snippets.json      # スニペット
    ├── stats-history.json # 統計履歴
    └── work-time.json     # 作業時間ログ

🔄 データストレージ戦略

デュアルストレージ:

• ローカル: logs/*.json にJSON形式で保存（オフライン対応）

• クラウド: SparkSheets にシートとして保存（共有・可視化）

🚀 今後の拡張予定

SparkSheets → Claude Code CLI

• シートで仕様書 → 自動実装

• タスクボード → 自動実行

• バグ報告 → 自動修正

使いながら必要な機能を随時追加予定。

📄 ライセンス

MIT

🤝 コントリビューション

Issue・PRは GitHub リポジトリ まで。