spirrow-prismind
OfficialProvides integration with Google Docs for document operations such as creating, updating, and retrieving documents.
Allows searching and retrieving documents from Google Drive, as well as creating and updating documents.
Enables synchronization of document catalogs with Google Sheets and managing project progress, including tasks and phases, via Sheets.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@spirrow-prismind search my catalog for 'project roadmap'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Spirrow-Prismind
MCP Server for Context-Aware Knowledge Management
An MCP (Model Context Protocol) server that integrates multiple data sources—Google Drive, RAG (Retrieval-Augmented Generation), and MCP Memory Server—to provide context-aware knowledge management for AI assistants.
Note: 日本語版は README.ja.md を参照してください。
Features
Session Management: Save and restore work states, automatically suggest relevant documents
Project Management: Switch between multiple projects, search for similar projects
Document Operations: Google Docs integration with automatic catalog registration
Catalog Management: Semantic search with Google Sheets synchronization
Knowledge Management: RAG-based knowledge storage and retrieval
Related MCP server: brkt-gdrive-mcp
Requirements
Python 3.11 or higher
Google Cloud project with OAuth 2.0 credentials
RAG server (ChromaDB compatible)
MCP Memory Server (optional)
Installation
# Clone the repository
git clone https://github.com/SpirrowGames/spirrow-prismind.git
cd spirrow-prismind
# Install the package
pip install -e .Configuration
Copy the example config:
cp config.toml.example config.tomlSet up Google OAuth credentials:
Create a project in Google Cloud Console
Enable Google Docs, Drive, and Sheets APIs
Create OAuth 2.0 credentials (Desktop application)
Download
credentials.jsonand place it in the config directory
Configure external services in
config.toml:RAG Server endpoint (ChromaDB compatible)
MCP Memory Server connection (optional)
Usage
With Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"prismind": {
"command": "spirrow-prismind",
"env": {
"PRISMIND_CONFIG": "/path/to/config.toml"
}
}
}
}With Claude Code
Add to your Claude Code settings:
{
"mcpServers": {
"prismind": {
"command": "spirrow-prismind",
"env": {
"PRISMIND_CONFIG": "/path/to/config.toml"
}
}
}
}Available Tools
Session Management
Tool | Description |
| Start a session and restore previous state |
| End session and save state for handoff |
| Save intermediate session state |
| List all sessions for a project |
| Delete a specific session |
| List the distinct context authors/roles saved for a project |
start_session / end_session / save_session / delete_session accept an
optional author argument. It adds a partition segment to the session key
(prismind:session:{project}:{user}:{author}), so one project+user can hold
multiple independent contexts — one per author/role. An empty author keeps
the legacy key for backward compatibility.
Project Management
Tool | Description |
| Set up a new project |
| Switch to another project |
| List all projects |
| Update project settings |
| Delete a project |
Document Operations
Tool | Description |
| Search and retrieve documents |
| Create a new document |
| Update an existing document |
Catalog Operations
Tool | Description |
| Search the document catalog |
| Sync catalog (Sheets → RAG) |
Knowledge Operations
Tool | Description |
| Add knowledge entries |
| Search knowledge base |
| Update an existing knowledge entry |
| Delete a knowledge entry |
Progress Management
Tool | Description |
| Get project progress with phases and tasks |
| Add a new task to progress sheet |
| Get single task details by ID |
| Update task (name, description, status, priority, phase move) |
| Delete task with blocked_by reference cleanup |
| Update task status |
| Mark task as in_progress |
| Mark task as completed |
| Mark task as blocked |
Architecture
┌──────────────────────────────────────────────────────────────┐
│ MCP Server │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Tools │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
│ │ │ Session │ │ Project │ │Document │ │Knowledge│ ... │ │
│ │ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ │
│ └───────┼──────────┼──────────┼──────────┼─────────────┘ │
│ │ │ │ │ │
│ ┌───────┴──────────┴──────────┴──────────┴─────────────┐ │
│ │ Integrations │ │
│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │
│ │ │ RAG │ │ Memory │ │ Docs │ │ Drive │ │ │
│ │ │ Client │ │ Client │ │ Client │ │ Client │ │ │
│ │ └────┬───┘ └────┬───┘ └────┬───┘ └────┬───┘ │ │
│ └───────┼──────────┼──────────┼──────────┼─────────────┘ │
└──────────┼──────────┼──────────┼──────────┼────────────────┘
│ │ │ │
▼ ▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────────────────┐
│ChromaDB│ │ Memory │ │ Google APIs │
│ RAG │ │ Server │ │ Docs/Drive/Sheets │
└────────┘ └────────┘ └────────────────────┘Development
Setup
# Install with dev dependencies
pip install -e ".[dev]"Testing
pytestCode Quality
# Format code
ruff format .
# Lint and fix
ruff check --fix .Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Related Projects
Model Context Protocol - The protocol specification
MCP Servers - Official MCP server implementations
Available Tools
46 toolsadd_knowledgeB
Add a knowledge entry to RAG. Store insights, tips, best practices, and lessons learned.
Inputs: content (required), category (required), tags, source, +1 more.
add_taskB
Add a new task to the progress sheet.
Inputs: name (required), phase (required), task_id (required), user, +5 more.
block_taskB
Mark a task as blocked with blockers list.
Inputs: phase (required), task_id (required), blockers (required), project.
check_services_statusB
Check connection status of RAG and Memory servers. Verifies server availability and collection/schema auto-creation status. Use detailed=true for protocol, latency, and other detailed info.
Inputs: detailed.
complete_taskB
Mark a task as completed. Convenience method that sets status to 'completed'.
Inputs: phase (required), task_id (required), notes, project.
configureA
Update Spirrow-Prismind configuration. Writes settings to config.toml.
Inputs: value (required), setting (required).
create_documentC
Create a new document and register it in the catalog.
Inputs: name (required), content (required), doc_type (required), phase_task (required), +3 more.
delete_documentA
Delete a document and its catalog entries. Requires project name to prevent accidental deletion.
Inputs: doc_id (required), project (required), soft_delete, delete_drive_file.
delete_document_typeA
Delete a document type. Use scope='global' for global types, or scope='project' for project-specific types.
Inputs: type_id (required), scope.
delete_knowledgeB
Delete a knowledge entry from RAG.
Inputs: knowledge_id (required), project.
delete_projectC
Delete project settings. Optionally delete the Google Drive folder as well.
Inputs: project (required), confirm, delete_drive_folder.
delete_sessionB
Delete a saved session state for a project.
Inputs: project (required), user, author.
delete_taskA
Delete a task from the progress sheet. Also cleans up blocked_by references in other tasks.
Inputs: phase (required), task_id (required), user, project.
end_sessionB
End the session and save state. Uses current project if project is not specified. Optionally declare 'embodiment' to record on the saved SessionState.
Inputs: notes, author, project, summary, +3 more.
export_server_configA
Export server configuration for team sharing. Outputs in TOML format excluding sensitive information (paths).
Inputs: no named parameters.
find_similar_document_typeA
Find a document type semantically similar to the query. Uses RAG-based semantic search (BGE-M3 embeddings) for multilingual matching. For example, 'api仕様' can match 'api_spec'.
Inputs: type_query (required), threshold.
get_connection_infoA
Get current connection information. Shows connection status, latency, and version info for Memory Server, RAG Server, and Google services.
Inputs: no named parameters.
get_documentC
Search and retrieve a document.
Inputs: query, doc_id, project, doc_type, +1 more.
get_identityA
Look up ONE identity record by name (cross-project, read-only). Use this -- not list_context_authors -- when you need a specific actor's allowed_roles / independence_class. list_context_authors is project-scoped and enumerates saved session state, so an identity that is registered but has never checkpointed in that project is absent from its output; treating that absence as 'unregistered' would silently skip Magickit's role x allowed_roles check. Response distinguishes 'not registered' (success=true, found=false) from 'lookup failed' (success=false) so callers can fail closed on the latter.
Inputs: identity_name (required), user.
get_progressC
Get project progress from Google Sheets.
Inputs: phase, project.
get_setup_statusA
Get the configuration status of Spirrow-Prismind. Shows required and optional settings with their configured/unconfigured state.
Inputs: no named parameters.
get_taskB
Get a single task by ID.
Inputs: phase (required), task_id (required), user, project.
import_server_configA
Import shared server configuration. Validates settings and reports any errors.
Inputs: config (required).
list_context_authorsA
List the distinct context authors/roles that have saved session state for a project. Use this to avoid creating duplicate contexts from naming variations and to check whether your own author's context already exists. Each entry carries an 'identity' object (or null) joined from the cross-project identity record (see upsert_identity), so callers see allowed_roles without a second lookup.
Inputs: project (required), user.
list_documentsB
List documents in a project with filtering and pagination.
Inputs: limit, offset, feature, project, +4 more.
list_document_typesA
Get a list of available document types. Returns both global types (shared across projects) and project-specific types. When same type_id exists in both, project type takes precedence.
Inputs: no named parameters.
list_projectsA
Get a list of registered projects.
Inputs: no named parameters.
list_sessionsA
List all saved sessions. Can filter by project or user.
Inputs: user, project.
register_document_typeA
Register a new document type. Use scope='global' for types shared across all projects, or scope='project' for project-specific types.
Inputs: name (required), type_id (required), folder_name (required), scope, +4 more.
save_sessionA
Save session state without ending the session. Uses current project if project is not specified. Optionally declare 'embodiment' to record on SessionState.
Inputs: notes, author, project, summary, +5 more.
search_catalogC
Search the document catalog.
Inputs: limit, query, feature, doc_type, +1 more.
search_knowledgeC
Search knowledge entries. Find relevant insights, tips, and lessons learned.
Inputs: query (required), tags, limit, project, +2 more.
setup_projectA
Set up a new project. If spreadsheet_id and root_folder_id are omitted, automatically creates them under the projects_folder_id configured in config.toml.
Inputs: name (required), project (required), force, description, +4 more.
start_sessionA
Start a session and load saved state. Uses current project if project is not specified. Specify 'author' to restore a specific context-author/role partition. Optionally declare 'embodiment' (ADR-2026-05-29-12 self-declared runtime form) to record on the loaded SessionState.
Inputs: author, project, embodiment.
start_taskA
Mark a task as in progress. Convenience method that sets status to 'in_progress'.
Inputs: phase (required), task_id (required), project.
switch_projectB
Switch to a different project.
Inputs: project (required).
sync_catalogB
Sync the catalog from Google Sheets to RAG cache.
Inputs: project.
sync_projects_from_driveA
Sync folder list under projects_folder_id in Google Drive with RAG. Uses Drive as master to add/remove projects.
Inputs: dry_run.
update_documentC
Update a document.
Inputs: doc_id (required), append, content, feature, +3 more.
update_knowledgeA
Update an existing knowledge entry.
Inputs: knowledge_id (required), tags, source, content, +1 more.
update_projectC
Update project settings.
Inputs: project (required), name, phases, status, +5 more.
update_session_progressC
Update session progress (phase, task, blockers). Uses current project if project is not specified. Optionally declare 'embodiment' to record on SessionState.
Inputs: author, project, blockers, embodiment, +3 more.
update_summaryB
Update the project summary sheet with information like description, current phase, and task counts.
Inputs: project, description, total_tasks, current_phase, +2 more.
update_taskA
Update a task with any combination of fields. Supports updating name, description, status, priority, category, blocked_by, blockers, and moving to a new phase.
Inputs: phase (required), task_id (required), name, user, +8 more.
update_task_statusC
Update task status in Google Sheets.
Inputs: phase (required), status (required), task_id (required), user, +6 more.
upsert_identityA
Create or update an identity record (cross-project actor declaration). Identity records persist allowed_roles / independence_class / persona_description in a key space separate from session state (prismind:identity:{user}:{identity_name}), realizing ADR-2026-05-27-09 D-3's persona-continuity gate at the API level. identity_name is the same string SessionState.author uses; list_context_authors joins the identity record onto each author entry so callers see allowed_roles in one round-trip. independence_class is required on every upsert (re-declared, not preserved) -- this is the '書き忘れ不能' guarantee. allowed_roles is required unless keep_allowed_roles=True. persona_description defaults to preserve-on-omit. embodiment is DEPRECATED (ADR-2026-05-29-12); runtime self-declared via the five APIs on Magickit (checkpoint/resume/chatroom_*). Pass omit or null; the field is preserved in the schema only for the staged migration window.
Inputs: identity_name (required), independence_class (required), user, embodiment, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 46 tools
Most tools target distinct resources/actions, but there is overlap between start_task/complete_task/block_task and update_task_status, as well as between check_services_status and get_connection_info, which could cause misselection. Descriptions help clarify intent, but the boundaries are not always clean.
All tools use snake_case with a clear verb_noun pattern (get_, list_, create_, update_, delete_, etc.). The verbs are consistent and predictable, with only minor special cases like 'configure' and 'upsert_identity'.
With 46 tools, this is significantly more than typical and feels heavy. Many convenience wrappers (e.g., start_task, complete_task, block_task) could be folded into update_task_status, and several config/status tools could be consolidated.
The tool surface covers CRUD and lifecycle operations for sessions, projects, documents, knowledge, and tasks, plus configuration and identity management. No major gaps are apparent; the domain appears fully covered.
Maintenance
Related MCP Connectors
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn advanced MCP server providing RAG-enabled memory through a knowledge graph with vector search capabilities, enabling intelligent information storage, semantic retrieval, and document processing.49 npm47MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for semantic search over Google Drive documents, enabling AI tools to search, list, and retrieve document content.MIT
- AlicenseAqualityBmaintenanceAn MCP server that enables LLMs to search, fetch, and act on Google Workspace (Drive, Gmail, Docs, Sheets, etc.) with rich, one-call results and file deposits to disk, reducing context usage.3MIT
- AlicenseAqualityDmaintenanceUnified MCP server for Google Classroom, Drive, and Docs, enabling AI assistants to manage courses, assignments, files, and documents.17MIT