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)

| Category | Tools | |----------|-------| | Auth | sparksheets_login, sparksheets_logout, sparksheets_auth_status | | Sessions | save_session, list_sessions, search_sessions, create_handover | | Knowledge | save_solution, find_solution, save_snippet, get_snippet | | Sheets | upload_image, append_to_sheet, list_sheets, create_sheet, update_sheet, get_sheet_content, search_sheets, delete_sheet, add_column, remove_column, get_column_info | | Stats | sync_stats, log_work_time, get_usage_dashboard | | Tasks | sync_todos, get_review_queue | | Spark | run_spark, list_sparks, translate_sheet | | Share & Members | create_share_link, get_share_settings, disable_share, list_members, add_member, update_member_role, remove_member |

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 リポジトリ まで。