surveymonkey-mcp

MCP server for the SurveyMonkey API v3.

Exposes SurveyMonkey as tools usable from Claude and any MCP-compatible client.

Features

• Users — get current user profile
• Surveys — list, get, get details, create, update, patch, delete
• Pages — list, get, create, update, delete
• Questions — list, get, create, update, delete
• Responses — list (metadata), list bulk (with answers), get, get details, delete, export CSV
• Collectors — list, get, create, update, delete
• Collector Messages — list, create, send
• Collector Recipients — list
• Webhooks — list, get, create, update, delete
• Contacts — list, get, create, delete
• Contact Lists — list, get, create, delete, list members

Authentication

Obtain a personal access token from the SurveyMonkey Developer Portal:

1. Log in at https://developer.surveymonkey.com/
2. Go to My Apps → create or open an app
3. Go to Settings → copy your Access Token

The token is passed via the SURVEYMONKEY_TOKEN environment variable.

Quick start

# Run directly (no install)
SURVEYMONKEY_TOKEN=your_token uvx --from git+https://github.com/dscovr/surveymonkey-mcp surveymonkey-mcp

# Or install as a uv tool
uv tool install git+https://github.com/dscovr/surveymonkey-mcp
SURVEYMONKEY_TOKEN=your_token surveymonkey-mcp

Claude Desktop / MCP client configuration

Copy .mcp.json.example to .mcp.json and fill in your token:

{
  "mcpServers": {
    "surveymonkey": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/dscovr/surveymonkey-mcp",
        "surveymonkey-mcp"
      ],
      "env": {
        "SURVEYMONKEY_TOKEN": "YOUR_SURVEYMONKEY_ACCESS_TOKEN"
      }
    }
  }
}

Available tools (48 total)

| Tool | Description | |---|---| | surveymonkey_get_me | Get current user profile | | surveymonkey_list_surveys | List surveys with filters | | surveymonkey_get_survey | Get survey metadata | | surveymonkey_get_survey_details | Get full survey with all pages & questions | | surveymonkey_create_survey | Create a new survey | | surveymonkey_update_survey | Replace a survey (PUT) | | surveymonkey_patch_survey | Partially update a survey (PATCH) | | surveymonkey_delete_survey | Delete a survey | | surveymonkey_list_pages | List pages of a survey | | surveymonkey_get_page | Get a page | | surveymonkey_create_page | Create a page | | surveymonkey_update_page | Update a page | | surveymonkey_delete_page | Delete a page | | surveymonkey_list_questions | List questions on a page | | surveymonkey_get_question | Get a question | | surveymonkey_create_question | Create a question | | surveymonkey_update_question | Update a question | | surveymonkey_delete_question | Delete a question | | surveymonkey_list_responses | List responses (metadata only) | | surveymonkey_list_responses_bulk | List responses with answers | | surveymonkey_get_response | Get a single response | | surveymonkey_get_response_details | Get a response with all answers | | surveymonkey_delete_response | Delete a response | | surveymonkey_export_responses_csv | Export all responses as CSV | | surveymonkey_list_collectors | List collectors for a survey | | surveymonkey_get_collector | Get a collector | | surveymonkey_create_collector | Create a collector | | surveymonkey_update_collector | Update a collector | | surveymonkey_delete_collector | Delete a collector | | surveymonkey_list_collector_messages | List email messages for a collector | | surveymonkey_create_collector_message | Create an email message | | surveymonkey_send_collector_message | Send an email message | | surveymonkey_list_collector_recipients | List recipients for a collector | | surveymonkey_list_webhooks | List webhooks | | surveymonkey_get_webhook | Get a webhook | | surveymonkey_create_webhook | Create a webhook | | surveymonkey_update_webhook | Update a webhook | | surveymonkey_delete_webhook | Delete a webhook | | surveymonkey_list_contacts | List contacts | | surveymonkey_get_contact | Get a contact | | surveymonkey_create_contact | Create a contact | | surveymonkey_update_contact | Update a contact | | surveymonkey_delete_contact | Delete a contact | | surveymonkey_list_contact_lists | List contact lists | | surveymonkey_get_contact_list | Get a contact list | | surveymonkey_create_contact_list | Create a contact list | | surveymonkey_delete_contact_list | Delete a contact list | | surveymonkey_list_contact_list_members | List members of a contact list |

Development

# Install dependencies
uv sync

# Run tests
uv run pytest

# Run the server locally
SURVEYMONKEY_TOKEN=your_token uv run python -m surveymonkey.server