Kobotoolbox MCP Server

Name: Kobotoolbox MCP Server
Author: drannakurasova

作者：drannakurasovaバージョン 0.1.0i★ –iパソコンで動く

レジストリ名io.github.drannakurasova/kobotoolbox-mcp-server

インストール

概要

作者による説明（英語の原文）

MCP server for KoboToolbox: list forms, fetch submissions, and export field data.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい↓ 33/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: 文書・表計算・事務作業
入力が必要なもの：KOBO_API_TOKEN

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： KOBO_API_TOKEN, KOBO_SERVER

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "kobotoolbox": {
      "command": "npx",
      "args": [
        "-y",
        "kobotoolbox-mcp-server"
      ],
      "env": {
        "KOBO_API_TOKEN": "your-value",
        "KOBO_SERVER": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add kobotoolbox --env KOBO_API_TOKEN=your-value --env KOBO_SERVER=your-value -- npx -y kobotoolbox-mcp-server

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "kobotoolbox": {
      "command": "npx",
      "args": [
        "-y",
        "kobotoolbox-mcp-server"
      ],
      "env": {
        "KOBO_API_TOKEN": "your-value",
        "KOBO_SERVER": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "kobotoolbox": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kobotoolbox-mcp-server"
      ],
      "env": {
        "KOBO_API_TOKEN": "your-value",
        "KOBO_SERVER": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

KOBO_API_TOKEN 秘密必須 env
KoboToolbox API token — find it under Account Settings → Security → Display.
KOBO_SERVER env
KoboToolbox host: kf.kobotoolbox.org (global, default) or eu.kobotoolbox.org (EU/Ireland)

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント drannakurasova で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

文書・表計算・事務作業のほかのサーバーとの比較i

このカテゴリのほかの3590件のうち0%よりスターが多い
このカテゴリのほかの3590件のうち19%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの3590件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Kobotoolbox MCP Serverは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：KOBO_API_TOKEN

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.1.0）がレジストリに届いたのは4 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Agent-Native Calendar, Excel MCP Server, MCP Server for Excel

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Agent-Native Calendar

Agent-Native Google Calendar - manage events, sync, and public booking

作者：BuilderIO広く使われている★ 76202 か月前更新

クラウドで動く

インストール

Excel MCP Server

Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.

作者：haris-musa広く使われている↓ 5万/週★ 42768 日前更新

パソコンで動く

インストール

MCP Server for Excel

Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.

作者：sbroenne成長中↓ 4321/週★ 8475 日前更新

パソコンで動く

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

KoboToolbox MCP Server

A [Model Context Protocol](https://modelcontextprotocol.io) server that lets Claude (or any MCP client) read and export field data directly from [KoboToolbox](https://www.kobotoolbox.org).

Ask in plain language — *"How many intakes came in this week that need medical attention?"* or *"Export this project's data as a CSV"* — and the assistant queries the live KoboToolbox API and answers from real records, instead of you logging in and clicking through the dashboard by hand.

As of July 2026, no KoboToolbox MCP server existed in the official MCP registry — this is the first.

Why KoboToolbox

KoboToolbox is the most widely used data-collection toolkit in humanitarian and development work. It's open-source, free to use, and runs the field operations of UNHCR and thousands of NGOs — surveys, needs assessments, monitoring — often in places with poor connectivity and no dedicated IT staff.

That last part is exactly why an MCP server matters here. The organizations running on KoboToolbox are the ones *least* likely to have engineers who can pull and analyze their own data on demand. Today, answering "what does this month's data actually say?" means a person logging in, filtering submissions by hand, exporting a spreadsheet, and counting. This server collapses that into a question typed in chat — and turns any MCP-capable assistant into someone who can operate the tool on the team's behalf.

There are already thousands of MCP servers for developer tooling and office apps. There were none for the platform that humanitarian responders actually run their work on. This closes that gap.

What it does

Three tools, mapped directly onto the KoboToolbox REST API v2. All read/export — this server never modifies or deletes your data.

Tool	What it does	Key inputs
`list_forms`	Lists every form/project in the connected account — name, UID, deployment status, submission count.	(none)
`get_submissions`	Fetches the submitted records for one form, with optional filtering, sorting, and pagination.	`assetUid` (required), `query`, `limit`, `start`, `sort`
`export_form_data`	Kicks off a server-side export, waits for it to finish, and returns a download URL.	`assetUid` (required), `format` (`csv`/`xls`/`geojson`/`spss_labels`), `fields`

Requirements

Node.js 18+
A KoboToolbox account (free — sign up) on either the global server (kf.kobotoolbox.org) or the EU server (eu.kobotoolbox.org)
Your account's API token

Getting your API token

Log into KoboToolbox, then either:

Account Settings → Security → Display your API key, or
visit https:// /token/?format=json

Treat this token like a password — it grants full access to your account's data.

Installation

git clone https://github.com/drannakurasova/kobotoolbox-mcp-server.git

cd kobotoolbox-mcp-server npm install npm run build

Configuration

Copy the example env file and fill in your token:

cp .env.example .env

KOBO_API_TOKEN=your_kobotoolbox_api_token_here

KOBO_SERVER=kf.kobotoolbox.org # or eu.kobotoolbox.org

Usage

With Claude Desktop

Add this to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

"mcpServers": { "kobotoolbox": { "command": "node", "args": ["/absolute/path/to/kobotoolbox-mcp-server/dist/index.js"], "env": { "KOBO_API_TOKEN": "your_token_here", "KOBO_SERVER": "kf.kobotoolbox.org" } } } }

Fully quit and reopen Claude Desktop. The kobotoolbox tools will appear in the tools menu, and you can just ask:

*"What forms are in my KoboToolbox account?"*

*"Show me the latest 10 submissions for the intake form."*

*"Export that project's data as a CSV."*

With the MCP Inspector

The Inspector is a browser-based test harness — the quickest way to exercise each tool directly (and to record a demo).

npm run inspect

It prints an authenticated URL; open it, click List Tools, select a tool, fill in the inputs, and hit Run Tool.

Development

npm run dev       # run from source with tsx (no build step)

npm run build # compile TypeScript to dist/ npm start # run the compiled server npm run inspect # launch the MCP Inspector against the built server

How it works

`src/index.ts` — defines the MCP server and registers the three tools, with input validation via Zod. Runs over stdio.
`src/kobo-client.ts` — a thin, typed wrapper around the KoboToolbox REST API v2 (token auth, form listing, submission fetch, and the create-then-poll export flow).

Credentials come only from environment variables — nothing is hardcoded, so the same server works against any KoboToolbox account or form.

Roadmap

Possible extensions:

Write access (create submissions, edit validation status)
Per-form schema/question introspection so the assistant understands field meanings
Support for private/self-hosted KoboToolbox instances

License

MIT

Kobotoolbox MCP Server

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

文書・表計算・事務作業のほかのサーバーとの比較i

よくある質問

代わりの候補

Agent-Native Calendar

Excel MCP Server

MCP Server for Excel

作者のREADME

KoboToolbox MCP Server

Why KoboToolbox

What it does

Requirements

Getting your API token

Installation

Configuration

Usage

With Claude Desktop

With the MCP Inspector

Development

How it works

Roadmap

License