SparkSheets MCP Server

1# SparkSheets MCP Server
2 
3MCP server for SparkSheets - AI-powered document platform integration for Claude Code, Cursor, and Cline.
4 
5[日本語](#-概要) | English
6 
7## Installation
8 
9```bash
10npm install -g @sparksheets/mcp
11```
12 
13## Quick Setup
14 
15Add to your `~/.claude.json`:
16 
17```json
18{
19  "mcpServers": {
20    "sparksheets": {
21      "command": "sparksheets-mcp"
22    }
23  }
24}
25```
26 
27Then login with your SparkSheets account:
28 
29```
30sparksheets_login
31```
32 
33## Features
34 
35- **Session Management** - Save and search development session history
36- **Knowledge Base** - Store error solutions and code snippets
37- **Usage Tracking** - Sync /stats output and work time
38- **Sheet Operations** - Create, edit, search sheets from CLI
39- **Spark Integration** - Run AI features from terminal
40 
41## Available Tools (37 tools)
42 
43| Category | Tools |
44|----------|-------|
45| Auth | `sparksheets_login`, `sparksheets_logout`, `sparksheets_auth_status` |
46| Sessions | `save_session`, `list_sessions`, `search_sessions`, `create_handover` |
47| Knowledge | `save_solution`, `find_solution`, `save_snippet`, `get_snippet` |
48| 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` |
49| Stats | `sync_stats`, `log_work_time`, `get_usage_dashboard` |
50| Tasks | `sync_todos`, `get_review_queue` |
51| Spark | `run_spark`, `list_sparks`, `translate_sheet` |
52| Share & Members | `create_share_link`, `get_share_settings`, `disable_share`, `list_members`, `add_member`, `update_member_role`, `remove_member` |
53 
54 
55## Documentation
56 
57- User Guide: https://sparksheets.ai/docs/guide/mcp/
58- SparkSheets: https://sparksheets.ai/
59 
60## License
61 
62MIT
63 
64---
65 
66# 日本語ドキュメント
67 
68Claude Code開発者のためのダッシュボード。セッション履歴、ナレッジベース、使用量統計、タスク管理をSparkSheetsで一元管理。
69 
70## 📋 概要
71 
72このMCPサーバーは、Claude CodeとSparkSheetsを統合し、以下を実現します：
73 
74- **セッション管理**: 開発セッションの履歴保存・検索
75- **ナレッジベース**: エラー解決策とコードスニペットの蓄積
76- **使用量追跡**: /stats出力の自動保存・可視化
77- **タスク管理**: TodoWriteの進捗同期
78- **シート操作**: SparkSheets CRUD操作
79- **Spark連携**: AIボタン機能のCLI実行
80 
81## 🛠️ インストール
82 
83### npm（推奨）
84 
85```bash
86npm install -g @sparksheets/mcp
87```
88 
89`~/.claude.json` に追加：
90 
91```json
92{
93  "mcpServers": {
94    "sparksheets": {
95      "command": "sparksheets-mcp"
96    }
97  }
98}
99```
100 
101### 手動インストール
102 
103```bash
104git clone https://github.com/sparksheets/mcp.git ~/.claude/mcp-servers/mcp-sparksheets
105cd ~/.claude/mcp-servers/mcp-sparksheets
106npm install
107```
108 
109`~/.claude.json` に追加：
110 
111```json
112{
113  "mcpServers": {
114    "sparksheets": {
115      "type": "stdio",
116      "command": "node",
117      "args": ["/Users/YOUR_USERNAME/.claude/mcp-servers/mcp-sparksheets/server.js"]
118    }
119  }
120}
121```
122 
123## 🔧 初回認証
124 
125Claude Codeで以下を実行：
126 
127```
128sparksheets_login
129```
130 
131または自然言語で：
132 
133```
134「SparkSheetsにログインして」
135```
136 
137ブラウザが開き、Googleアカウントで認証後、自動的にトークンが保存されます。
138 
139**トークン保存場所**: `~/.sparksheets/tokens.json`
140 
141## 🛠️ 実装ツール一覧（37ツール）
142 
143### 認証（3ツール）
144- `sparksheets_login` - SparkSheetsにログインします。ブラウザが開き、Googleアカウントで認証後、自動的にトークンが保存されます。
145- `sparksheets_logout` - SparkSheetsからログアウトします。保存されたトークンを削除します。
146- `sparksheets_auth_status` - 現在の認証状態を確認します。ログイン中のユーザー情報やトークンの有効期限を表示します。
147 
148### セッション管理（4ツール）
149- `save_session` - 現在のセッション要約をSparkSheetsに保存
150- `list_sessions` - 全セッション一覧を取得
151- `search_sessions` - キーワードでセッション検索
152- `create_handover` - 引き継ぎシート自動生成（次にやること、注意点などをまとめる）
153 
154### ナレッジベース（4ツール）
155- `save_solution` - エラー解決策を辞典に保存
156- `find_solution` - 過去の解決策を検索
157- `save_snippet` - コードスニペットを保存
158- `get_snippet` - スニペットを取得・検索
159 
160### シート操作（11ツール）
161- `upload_image` - 画像をSparkSheetsにアップロード。Base64またはファイルパスを指定。戻り値にMarkdown形式の画像タグを含む
162- `append_to_sheet` - シートの指定カラムの末尾にコンテンツを追記
163- `list_sheets` - シート一覧取得
164- `create_sheet` - 新規シート作成
165- `update_sheet` - シート編集
166- `get_sheet_content` - シート内容取得（オプションでコンテキスト制御可能）
167- `search_sheets` - シート検索
168- `delete_sheet` - シート削除
169- `add_column` - シートにカラムを追加（最大3カラムまで）
170- `remove_column` - シートからカラムを削除
171- `get_column_info` - シートのカラム情報を取得
172 
173### 統計・作業時間（3ツール）
174- `sync_stats` - /statsの内容をSparkSheetsに同期
175- `log_work_time` - 作業時間を記録
176- `get_usage_dashboard` - 使用量ダッシュボードURL取得
177 
178### タスク管理（2ツール）
179- `sync_todos` - TodoWriteの内容をSparkSheetsに同期
180- `get_review_queue` - PRレビューキュー取得（GitHub連携）
181 
182### Spark連携（3ツール）
183- `run_spark` - Spark（AIボタン）をCLIから実行
184- `list_sparks` - 利用可能なSpark一覧
185- `translate_sheet` - シートを多言語翻訳
186 
187### 共有・メンバー管理（7ツール）
188- `create_share_link` - シートの共有リンクを発行。既存のアクティブな共有がある場合は再利用される
189- `get_share_settings` - シートの現在の共有設定を取得
190- `disable_share` - 共有リンクを無効化
191- `list_members` - シートのメンバー一覧を取得
192- `add_member` - シートにメンバーを追加（招待）。オーナーのみ実行可能
193- `update_member_role` - メンバーの権限を変更。オーナーのみ実行可能
194- `remove_member` - シートからメンバーを削除。オーナーのみ実行可能
195 
196 
197## 📝 使用例
198 
199### セッション保存
200```
201「今日の作業をSparkSheetsに保存して」
202→ save_session ツールが実行される
203→ https://sparksheets.ai/sheet/xxx に保存
204```
205 
206### エラー辞典
207```
208「このCORSエラーの解決策、保存しておいて」
209→ save_solution ツールが実行
210 
211「CORSエラーの直し方、前に保存したやつ見せて」
212→ find_solution("CORS") で検索
213```
214 
215### 引き継ぎシート
216```
217「引き継ぎシート作って」
218→ create_handover ツールが実行
219→ 次にやること、注意点、関連ファイルがまとまったシート生成
220```
221 
222### 統計同期
223```
224「/statsの結果をSparkSheetsに保存して」
225→ sync_stats ツールが実行
226→ グラフ化されたダッシュボードで確認可能
227```
228 
229## 🗂️ ファイル構成
230 
231```
232~/.claude/mcp-servers/mcp-sparksheets/
233├── server.js              # MCPサーバー本体
234├── package.json
235├── README.md              # このファイル
236├── tools/
237│   ├── auth.js            # 認証ツール
238│   ├── sessions.js        # セッション管理ツール
239│   ├── knowledge.js       # ナレッジベースツール
240│   ├── stats.js           # 統計ツール
241│   ├── tasks.js           # タスク管理ツール
242│   ├── sheets.js          # シート操作ツール
243│   └── spark.js           # Spark連携ツール
244├── lib/
245│   ├── api-client.js      # SparkSheets API ラッパー
246│   └── storage.js         # ローカルJSON保存
247└── logs/
248    ├── sessions.json      # セッション履歴
249    ├── solutions.json     # エラー辞典
250    ├── snippets.json      # スニペット
251    ├── stats-history.json # 統計履歴
252    └── work-time.json     # 作業時間ログ
253```
254 
255## 🔄 データストレージ戦略
256 
257**デュアルストレージ**:
258- **ローカル**: `logs/*.json` にJSON形式で保存（オフライン対応）
259- **クラウド**: SparkSheets にシートとして保存（共有・可視化）
260 
261## 🚀 今後の拡張予定
262 
263### SparkSheets → Claude Code CLI
264- シートで仕様書 → 自動実装
265- タスクボード → 自動実行
266- バグ報告 → 自動修正
267 
268使いながら必要な機能を随時追加予定。
269 
270## 📄 ライセンス
271 
272MIT
273 
274## 🤝 コントリビューション
275 
276Issue・PRは [GitHub リポジトリ](https://github.com/sparksheets/mcp) まで。
277