tableurs

---

title: Tableurs sidebar_label: Tableurs (7) sidebar_position: 8 doc_type: reference

Tableurs

En bref

Lisez, ecrivez et interrogez vos feuilles de calcul collaboratives.

Prerequis

• Cle API avec le preset MCP et les scopes requis
• Client MCP configure (voir Configuration)

Exemples minimaux

Lire et interroger un tableur

1. Listez vos tableurs :

{
  "name": "spreadsheets_list",
  "arguments": {}
}

2. Lisez les lignes :

{
  "name": "spreadsheets_read_rows",
  "arguments": {
    "spreadsheetId": "uuid-du-tableur",
    "limit": 20
  }
}

3. Interrogez en langage naturel :

{
  "name": "spreadsheets_query_nl",
  "arguments": {
    "spreadsheetId": "uuid-du-tableur",
    "query": "clients actifs ce mois"
  }
}

---

spreadsheets_delete_rows

Supprime des lignes d'un tableur.

Scope	mcp.write
Lecture seule	Non
Destructif	Oui
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
rowIds	array	Oui	Row IDs (uuid) to delete (max 500)
sheetId	string (uuid)	Oui	Spreadsheet ID (uuid)
tabId	string (uuid)	Non	Optional tab id (uuid) to scope deletions to a tab

Reponse

Champ	Type	Description
success	boolean
rowsDeleted	number
rowIds	array
warnings	array

Outils lies : spreadsheets_read_rows, spreadsheets_write_rows, spreadsheets_get_schema

---

spreadsheets_get

Recupere la structure et les metadonnees d'un tableur.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
sheetId	string (uuid)	Oui	Spreadsheet ID (uuid)

Reponse

Champ	Type	Description
spreadsheet	object
id	string
name	string
description	string
columns	array
settings	unknown
rowCount	number
updatedAt	string
isLocked	boolean
isSourceLinked	boolean
deletedAt	string
tabs	array

Outils lies : spreadsheets_list, spreadsheets_get_schema, spreadsheets_read_rows

---

spreadsheets_get_schema

Recupere le schema d'un tableur (colonnes, types) avec apercu optionnel.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
sheetId	string (uuid)	Non	Spreadsheet ID (uuid) (defaut : 0)

Reponse

Champ	Type	Description
spreadsheet	object
id	string
name	string
description	string
rowCount	number
isLocked	boolean
isSourceLinked	boolean
deletedAt	string
columns	array
sampleRows	array

Outils lies : spreadsheets_get, spreadsheets_read_rows, spreadsheets_write_rows

---

spreadsheets_list

Liste les tableurs collaboratifs de votre workspace.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
includeTrash	boolean	Non	Include soft-deleted spreadsheets (defaut : false)
limit	number	Non	Nombre maximum de resultats (defaut : 50)
offset	number	Non	Decalage pour la pagination (defaut : 0)
search	string	Non	Search by spreadsheet name (ILIKE)

Reponse

Champ	Type	Description
spreadsheets	array
id	string
name	string
description	string
rowCount	number
updatedAt	string
isPinned	boolean
isSourceLinked	boolean
deletedAt	string
total	number
hasMore	boolean

Exemple

{
  "name": "spreadsheets_list",
  "arguments": {}
}

Outils lies : spreadsheets_get, spreadsheets_get_schema

---

spreadsheets_query_nl

Interroge un tableur en langage naturel.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
limit	number	Non	Maximum rows to return (defaut : 50)
query	string	Non	Natural language query, e.g. "clients avec CA > 100000"

Reponse

Champ	Type	Description
plan	object
interpretedQuery	string
spreadsheetIds	array
filters	array
warnings	array
confidence	number
isExecutable	boolean
results	array
total	number
hasMore	boolean

Outils lies : spreadsheets_list, spreadsheets_read_rows, spreadsheets_get_schema

---

spreadsheets_read_rows

Lit les lignes d'un tableur avec pagination.

Scope	mcp.read
Lecture seule	Oui
Destructif	Non
Idempotent	Oui

Parametres

Parametre	Type	Requis	Description
sheetId	string (uuid)	Oui	Spreadsheet ID (uuid)
cursorRowNumber	number	Non	Return rows with row_number > cursorRowNumber (defaut : 0)
limit	number	Non	Maximum rows to return (defaut : 200)
tabId	string (uuid)	Non	Optional tab ID (uuid)

Reponse

Champ	Type	Description
rows	array
nextCursorRowNumber	number
hasMore	boolean

Outils lies : spreadsheets_get, spreadsheets_get_schema, spreadsheets_query_nl

---

spreadsheets_write_rows

Insere ou met a jour des lignes dans un tableur.

Scope	mcp.write
Lecture seule	Non
Destructif	Oui
Idempotent	Non

Parametres

Parametre	Type	Requis	Description
data	record	Oui	Row data as { columnId: value }
rowId	string (uuid)	Non	Existing row id (uuid) for update/upsert
rowNumber	number	Non	Optional row_number to target (upsert by row_number)

Reponse

Champ	Type	Description
success	boolean
operation	enum
rowsAffected	number
rowIds	array
warnings	array

Outils lies : spreadsheets_get_schema, spreadsheets_read_rows, spreadsheets_delete_rows

Besoin d'aide ?

Ecrivez-nous : Support et contact.