Deployed on Cloudflare Workers for global distribution and performance
Supports CI workflows through GitHub Actions integration
Uses Jest for testing with coverage thresholds enforced via configuration
Utilizes the mcp-remote package from npm for secure connections
Built with TypeScript for full type safety in the implementation
Tally MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with secure access to Tally.so form management capabilities.
New to Tally?
Use the badge above to save 50% for 3 months.
I'll earn a small commission (at no extra cost to you) which helps fund ongoing maintenance of this open‑source project.
About
Tally MCP Server brings the power of Tally.so form management directly into your AI workflow. Instead of context-switching between your AI assistant and Tally's web interface, simply describe what you need in natural language and let the AI handle all the API interactions.
Why This Exists
Form creation and management shouldn't break your flow. Whether you're a developer creating test forms, a content creator building registration pages, or anyone who finds themselves constantly jumping between tools, this MCP server keeps you in the conversation.
Key Features
🎯 Natural Language Form Management
Create forms by describing what you need: "Build a client intake form with name, email, and project details"
Update existing forms without opening the Tally interface
Clone successful forms as templates for future use
🛡️ Safety-First Bulk Operations
Delete multiple forms using pattern matching ("all forms starting with 'E2E Test'")
Mandatory preview → confirm → execute workflow prevents accidents
Granular exclusion controls ("delete all test forms except these 3 templates")
📊 Complete Form Lifecycle
Real-time response analytics and completion rates
Export submissions to CSV/JSON
Team management and permission controls
Workspace organization tools
⚡ Developer Experience
Built in TypeScript with full type safety
Deployed on Cloudflare Workers for global speed
90% test coverage
Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client
Perfect For
Developers who create lots of test forms and need easy cleanup
Content creators building registration forms for workshops and events
Teams managing multiple form projects across workspaces
Anyone tired of clicking through form builders when they could just describe what they want
Transform form management from a context-breaking chore into a seamless part of your AI-powered workflow.
🚀 Quick Start
Step 0 – Create a discounted Tally account (optional)
If you don't already have a Tally account, grab the 50% builder's discount before continuing. You'll support this repo while saving money—win‑win!
Option 1: Claude.ai Integration (Recommended)
Use the battle-tested mcp-remote
package:
Claude Desktop Configuration (~/Library/Application Support/Claude/claude_desktop_config.json
):
Replace YOUR_AUTH_TOKEN
with your personal server authentication token.
Option 2: Direct Integration (Cursor, etc.)
For clients that support custom headers:
Option 3: Local Proxy (Alternative)
If you prefer a custom solution:
Start the local proxy:
npm run proxyConfigure Claude.ai:
Server URL:
http://localhost:3001/mcp
Transport:
http-stream
Authentication: None
🔧 Configuration
The server uses your personal authentication token to securely access your Tally data.
Required Environment Variables:
TALLY_API_KEY
: Your Tally API key (configured in Cloudflare Workers)AUTH_TOKEN
: Server authentication token (configured in Cloudflare Workers)
🛡️ Security
✅ Server-level authentication: Only authorized users can access your data
✅ Secure bridge: mcp-remote handles authentication transparently
✅ Encrypted transport: All communications use HTTPS
✅ Token-based auth: Industry standard Bearer token approach
🛠️ Available Tools
create_form: Create new Tally forms with custom fields
modify_form: Update existing form configurations
get_form: Retrieve detailed form information
list_forms: Browse all your forms
delete_form: Remove forms you no longer need
get_submissions: Access form submission data
analyze_submissions: Get insights from form responses
share_form: Generate sharing links and embed codes
manage_workspace: Handle workspace settings
manage_team: Team member and permission management
📱 Multi-Client Support
Supported MCP Clients:
✅ Claude.ai (via mcp-remote)
✅ Cursor (direct authenticated or via mcp-remote)
✅ Windsurf (via mcp-remote)
✅ Any MCP client supporting HTTP Stream transport
🔄 Development
Local Development
Testing
Continuous Integration
In your CI (e.g., GitHub Actions), run:
Jest enforces a >90% coverage threshold via jest.config.js
, causing the build to fail if coverage is below this level.
Deployment
📚 Documentation
MCP Protocol: Model Context Protocol
Tally API: Tally Developer Documentation
Cloudflare Workers: Workers Documentation
mcp-remote: NPM Package
🤝 Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request
📄 License
MIT License - see LICENSE file for details.
Built by
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Manage Tally.so forms through AI conversation. Create, update, and organize forms using natural language instead of web interfaces. Features safe bulk operations and works with all major MCP clients.
Related MCP Servers
- AsecurityAlicenseAqualityA server that allows AI agents to interact with the Tally API to access DAO governance data, proposals, and metadata using Model Context Protocol (MCP), built with TypeScript and GraphQL.Last updated -06MIT License
- -securityFlicense-qualityEnables form management, response handling, and analytics through the Fillout.io API for enhanced form interactions and insights.Last updated -
- -securityFlicense-qualityEnables interaction with Curri's API by managing text notes, offering tools for note creation, and generating summaries using structured prompts.Last updated -
- -securityAlicense-qualityEnables AI assistants to perform up-to-date web searches through the Tavily API, providing comprehensive search results with AI-generated summaries.Last updated -6MIT License