formbox-mcp

MCP server for FormBox - manage form submissions from Claude Code.

Setup

1. Get your API key

Go to FormBox Settings and generate an API key.

2. Add to your Claude Code configuration

Add to your .mcp.json:

{
  "formbox": {
    "command": "npx",
    "args": ["-y", "formbox-mcp"],
    "env": {
      "FORMBOX_API_KEY": "your-api-key-here"
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | health_check | Check the health status of all forms | | check_new_inquiries | Get unread inquiries across all forms | | read_inquiry | Read inquiry details and mark as read | | mark_as_read | Mark an inquiry as read | | list_forms | List all forms with submission counts | | setup_client_form | Create a new form for a client website | | search_submissions | Search submissions with filters |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | FORMBOX_API_KEY | Yes | - | Your FormBox API key | | FORMBOX_URL | No | https://form.web7.tokyo | FormBox server URL |

License

MIT