SparkSheets/sparksheets-mcp

MCP server for SparkSheets - AI-powered document platform integration for Claude Code, Cursor, and Cline.
日本語 | English
Installation
Quick Setup
Add to your ~/.claude.json:
Then login with your SparkSheets account:
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（推奨）
~/.claude.json に追加：
手動インストール
~/.claude.json に追加：
🔧 初回認証
Claude Codeで以下を実行：
または自然言語で：
ブラウザが開き、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 - シートのカラム情報を取得