Kobo MCP

An MCP server for KoboToolbox that enables Claude to deploy surveys and fetch submissions.

Features

list_forms - List all KoboToolbox surveys
get_form - Get detailed form information
get_submissions - Fetch survey responses
deploy_form - Upload and deploy XLSForm files
replace_form - Update existing forms preserving submissions
export_data - Export data as CSV or Excel

Installation

pip install kobo-mcp

Or run directly with uvx (no install):

uvx kobo-mcp

Configuration

1. Get your API token

Go to KoboToolbox → Account Settings → Security → Display

2. Add to Claude

Add to ~/.claude.json:

{
  "mcpServers": {
    "kobotoolbox": {
      "type": "stdio",
      "command": "kobo-mcp",
      "env": {
        "KOBO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Or with uvx:

{
  "mcpServers": {
    "kobotoolbox": {
      "type": "stdio",
      "command": "uvx",
      "args": ["kobo-mcp"],
      "env": {
        "KOBO_API_TOKEN": "your-token-here"
      }
    }
  }
}

For EU server, add "KOBO_SERVER": "https://eu.kobotoolbox.org" to env.

Development

git clone https://github.com/bbdaniels/kobo-mcp.git
cd kobo-mcp
pip install -e .

License

MIT

Metadata

Release files for kobo-mcp 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kobo-mcp 0.1.4
File	Size	Uploaded	Provenance
kobo_mcp-0.1.4.tar.gz	7.9 kB	Feb 6, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for kobo-mcp 0.1.4
File	Interpreter	ABI	Platform	Reset
kobo_mcp-0.1.4-py3-none-any.whl 8.9 kB Feb 6, 2026 With provenance	Python 3	none	any	Details

Total release size: 16.8 kB

Release files / kobo_mcp-0.1.4.tar.gz

Download URL	kobo_mcp-0.1.4.tar.gz
Size	7.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`31004f33de19729b64b1d58c52a8cadeeec419e967fe5223c30b2a78ce1af471`
BLAKE2b-256 checksum How to use checksums	`9eea8437141631431b38bcb2327753b84cb25f909713bd8a1a58e42d56562d79`
Upload date	Feb 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bbdaniels/kobo-mcp
Publishing commit: github.com/bbdaniels/kobo-mcp/tree/842b58247669f25f5075e2c9a3ec248c79e8479b

Workflow

Publishing configuration: github.com/bbdaniels/kobo-mcp/blob/842b58247669f25f5075e2c9a3ec248c79e8479b/.github/workflows/publish.yml
Publishing logs: github.com/bbdaniels/kobo-mcp/actions/runs/21738564048/attempts/1

Artifact

Subject: kobo_mcp-0.1.4.tar.gz
SHA-256 checksum: 31004f33de19729b64b1d58c52a8cadeeec419e967fe5223c30b2a78ce1af471 Verifying attestations

Release files / kobo_mcp-0.1.4-py3-none-any.whl

Download URL	kobo_mcp-0.1.4-py3-none-any.whl
Size	8.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c7cfab9e95a7e09dab410f96059e0ef0f929f0e3eeed6af683a701ddbceff460`
BLAKE2b-256 checksum How to use checksums	`2f50b533d8c533738cc2c073e7e2351308122fe48de6529d4926a15e1fe898c8`
Upload date	Feb 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bbdaniels/kobo-mcp
Publishing commit: github.com/bbdaniels/kobo-mcp/tree/842b58247669f25f5075e2c9a3ec248c79e8479b

Workflow

Publishing configuration: github.com/bbdaniels/kobo-mcp/blob/842b58247669f25f5075e2c9a3ec248c79e8479b/.github/workflows/publish.yml
Publishing logs: github.com/bbdaniels/kobo-mcp/actions/runs/21738564048/attempts/1

Artifact

Subject: kobo_mcp-0.1.4-py3-none-any.whl
SHA-256 checksum: c7cfab9e95a7e09dab410f96059e0ef0f929f0e3eeed6af683a701ddbceff460 Verifying attestations

Security for kobo-mcp 0.1.4

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for kobo_mcp-0.1.4.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bbdaniels/kobo-mcp
Publishing commit: github.com/bbdaniels/kobo-mcp/tree/842b58247669f25f5075e2c9a3ec248c79e8479b

Workflow

Publishing configuration: github.com/bbdaniels/kobo-mcp/blob/842b58247669f25f5075e2c9a3ec248c79e8479b/.github/workflows/publish.yml
Publishing logs: github.com/bbdaniels/kobo-mcp/actions/runs/21738564048/attempts/1

Artifact

Subject: kobo_mcp-0.1.4.tar.gz
SHA-256 checksum: 31004f33de19729b64b1d58c52a8cadeeec419e967fe5223c30b2a78ce1af471 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.