Apartment Sheets MCP (AS-MCP)

Un servidor ligero de Protocolo de Contexto de Modelo (MCP) que permite a Claude (u otras plataformas) guardar y gestionar listados de apartamentos en una hoja de cálculo de Google compartida.

Antecedentes

Este proyecto se ha inspirado en el frenético proceso de búsqueda de apartamentos que tenemos aquí en Nueva York.

¿Por qué una hoja de cálculo de Google?

1. Google ofrece un servicio de API generoso

2. No hay medio más sencillo para compartir tu búsqueda de apartamento con tu(s) compañero(s) de piso o pareja

Related MCP server: google-sheets-mcp

Notas

Debido a que esto es un MCP, utiliza la plataforma de IA de tu elección para manejar el web scraping, la actualización de listados y más. Todo lo que hace este MCP es darle a tu herramienta de IA preferida la conectividad con tu hoja de cálculo respectiva.

Herramientas disponibles

• save_listing : añade un nuevo listado a tu hoja de cálculo

• get_listing : obtiene todos los listados, con filtros opcionales (Barrio y Estado actual)

• update_listing : actualiza cualquier campo en un listado existente

• delete_listing : elimina un listado de la hoja de cálculo

Configuración

¡tienes que clonar este repositorio, obviamente!

1. Credenciales de Google Cloud

• Crea una cuenta de servicio en Google Cloud Console

• Habilita las APIs de Google Sheets y Google Drive

• Descarga el JSON de credenciales y guárdalo como credentials.json (colócalo en la raíz del proyecto)

• Comparte tu hoja de cálculo de Google con el correo electrónico de la cuenta de servicio como Editor

2. Instalar dependencias

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Configurar Claude desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nyc-apartment-tracker": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/server.py"],
      "cwd": "/path/to/nyc-apartment-mcp"
    }
  }
}

Variables de entorno

Nota de seguridad

Si planeas hacer push a git, ¡asegúrate de no subir nunca credentials.json!