English Français العربية

io.github.RyanKramer/wisegrid-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

Read and write WiseGrid sheets, rows, columns and reports from any AI agent.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package wisegrid-mcp
Claude Code 
claude mcp add wisegrid-mcp -e 'WISEGRID_API_KEY=<your wisegrid_api_key>' -e 'WISEGRID_BASE_URL=<WISEGRID_BASE_URL>' -- uvx wisegrid-mcp==0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "wisegrid-mcp": {
            "command": "uvx",
            "args": [
                "wisegrid-mcp==0.1.0"
            ],
            "env": {
                "WISEGRID_API_KEY": "<your wisegrid_api_key>",
                "WISEGRID_BASE_URL": "<WISEGRID_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • WISEGRID_API_KEY إلزامي سري WiseGrid API key (create one under Settings)
  • WISEGRID_BASE_URL Override the API base URL for self-hosted instances

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. WiseGrid MCP
  2. Install
  3. Tools
  4. Things that will bite you otherwise
  5. Development
  6. About

WiseGrid MCP

Read and write WiseGrid sheets from Claude, Cursor, or any MCP client. List sheets, page through rows, add and update records, and run reports — from inside a conversation.

Unlike the other servers in this family, these tools operate on your real data, so an API key is required.

Install

{
  "mcpServers": {
    "wisegrid": {
      "command": "uvx",
      "args": ["wisegrid-mcp"],
      "env": {
        "WISEGRID_API_KEY": "wg_live_xxx"
      }
    }
  }
}

Or pip install wisegrid-mcp.

VariableRequiredPurpose
WISEGRID_API_KEYyesCreate one in WiseGrid under Settings
WISEGRID_BASE_URLnoOverride for self-hosted instances

The key's scopes decide what these tools can reach. Grant read-only scopes if you only want the agent to look.

Tools

ToolWhat it does
whoamiThe key's identity, scopes and rate limit — call this first when debugging
list_sheetsSheets the key can see, cursor-paginated
get_sheetSheet + columns + first page of rows, in one call
list_columnsColumn IDs, which cell dictionaries are keyed by
list_rowsRows, cursor-paginated; each carries the version you need to update it
add_rowsBulk insert, partial success, max 2000
update_rowUpdate one row's changed cells, version-checked
update_rowsBulk update, version-checked per row, max 2000
delete_rowDelete a row and its subtree — requires confirm=True
list_reports / get_report / run_reportReports and their rows

Things that will bite you otherwise

Cells are keyed by column ID, not column name. {"101": "Acme Corp"}, not {"Client": "Acme Corp"}. Call get_sheet or list_columns first.

Updates are version-checked. Every row carries a version; you pass the one you read, and if the row changed in the meantime you get version_conflict instead of a silent overwrite. That is a normal outcome to handle — re-read the row, decide whether your change still applies, then retry. Blindly bumping the version to force the write is how concurrent edits disappear.

update_row merges, update_rows overwrites. The single-row tool takes only the cells you changed. The bulk tool replaces the row's cell set, so send the full set you want the row to end up with.

delete_row takes the children too. It removes the row and its entire subtree, it is not undoable through the API, and it requires confirm=True for exactly that reason. Read the rows first.

Writes are idempotent. Each carries an Idempotency-Key, so a retry after a timeout cannot double-apply. Rate limits are honoured via Retry-After.

Development

git clone https://github.com/RyanKramer/wisegrid-mcp
cd wisegrid-mcp
pip install -e .
WISEGRID_API_KEY=wg_live_xxx wisegrid-mcp

About

Built by WiseGrid. Full REST API reference at wisegrid.co/docs/api.

MIT licensed.

الأسئلة الشائعة

ما هو io.github.RyanKramer/wisegrid-mcp؟

Read and write WiseGrid sheets, rows, columns and reports from any AI agent.

كيف أثبّت io.github.RyanKramer/wisegrid-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add wisegrid-mcp -e 'WISEGRID_API_KEY=<your wisegrid_api_key>' -e 'WISEGRID_BASE_URL=<WISEGRID_BASE_URL>' -- uvx wisegrid-mcp==0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.RyanKramer/wisegrid-mcp إلى مفتاح API؟

نعم. يتطلب WISEGRID_API_KEY، وتضبطها في إعداداته.

هل io.github.RyanKramer/wisegrid-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.RyanKramer/wisegrid-mcp؟

ينشره RyanKramer. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.