WeMush Claude Connector

Connect your WeMush account to Claude AI for intelligent mycology research assistance. The WeMush Claude Connector enables Claude to access your research projects, specimens, and cultivation data to provide personalized insights and recommendations.

Overview

The WeMush Claude Connector uses the Model Context Protocol (MCP) to securely connect your WeMush account with Claude AI. Once connected, Claude can:

  • Track Your Specimens: Query and analyze your mushroom cultivation specimens across their lifecycle
  • Research Projects: Help you participate in citizen science projects and submit observations
  • Cultivation Insights: Provide AI-powered recommendations based on species, strain, and environmental factors
  • Analytics: Access aggregated research statistics with privacy-preserving k-anonymity
  • Catalog Access: Browse species, strains, and cultivation techniques from the WeMush knowledge base

Getting Started

Prerequisites

Before connecting WeMush to Claude, you need:

  1. An active WeMush account
  2. Access to Claude AI (via claude.ai or Claude Desktop)
  3. At least one organization membership on WeMush

Connecting Your Account

  1. In Claude, look for the WeMush connector in the MCP integrations menu
  2. Click "Connect" to start the OAuth authorization flow
  3. Log in to your WeMush account if prompted
  4. Review the requested permissions and click "Authorize"
  5. You're connected! Claude can now access your WeMush data

See It in Action

WeMush Claude Connector demo showing the connection flow

Demo: Connecting WeMush to Claude and querying your mycology data

Understanding Permissions

When you connect, you'll be asked to approve specific scopes:

ScopeWhat It Allows
profile:readView your research profile and activity
research:readView research projects and your enrollments
research:writeJoin projects and submit observations
specimens:readView your specimen data
observations:readView research observations
observations:writeCreate new observations
analytics:readAccess aggregated analytics
catalog:readBrowse species and strain catalog

You can revoke access at any time from WeMush Settings > Connected Apps.

Available Tools

The WeMush connector provides 33 tools organized into six categories:

Research Tools

ToolDescription
list_research_projectsList available research projects with filtering
get_research_projectGet detailed information about a specific project
enroll_in_projectJoin a research project as a participant
withdraw_from_projectLeave a research project
get_my_enrollmentsList your research project enrollments

Observation Tools

ToolDescription
create_observationSubmit a research observation
list_my_observationsList your submitted observations
get_observationGet details of a specific observation
update_observationUpdate an observation (before verification)
delete_observationDelete an observation (before verification)

Specimen Tools

ToolDescription
list_my_specimensList your specimens with filtering
get_specimen_detailsGet detailed specimen information
get_specimen_lineageView specimen ancestry and descendants
get_specimen_analyticsGet predictions and analytics for a specimen
record_specimen_observationRecord an observation on a specimen
get_specimen_historyView observation history for a specimen

Analytics Tools

ToolDescription
get_project_analyticsGet aggregated project statistics
get_outcome_breakdownView outcome distribution data
get_equipment_analysisAnalyze equipment correlation
get_group_comparisonCompare experiment groups
get_research_trendsView research activity trends

Catalog Tools

ToolDescription
search_speciesSearch species in the catalog
get_species_detailsGet cultivation information for a species
search_strainsSearch strains in the catalog
get_strain_detailsGet strain-specific information

Profile Tools

ToolDescription
get_my_research_profileView your research profile and statistics
get_research_activity_feedView your recent activity feed

Prompts

The connector includes five pre-built prompts for common workflows:

Analyze Cultivation

"Use the analyze_cultivation prompt for my grain spawn jar"

Claude will fetch your specimen details, recent observations, and strain information to provide a comprehensive analysis with recommendations.

Research Project Overview

"Give me an overview of the Substrate Colonization Study"

Get a summary of any research project including participation statistics, key findings, and how to contribute.

Strain Comparison

"Compare Blue Oyster and Italian Oyster strains"

Claude will present a structured comparison of cultivation requirements, expected yields, and difficulty levels.

Troubleshoot Cultivation

"Help me troubleshoot green contamination on my grain spawn"

Get diagnostic assistance for common cultivation problems with actionable solutions.

Summarize Activity

"Summarize my research activity this month"

View a summary of your contributions, observations, and project participation.

Resources

The connector provides access to three resources:

ResourceDescription
Cultivation GuideBest practices for mushroom cultivation
Research GlossaryDefinitions of mycology and research terms
My Research ProfileYour profile, enrollments, and statistics

Privacy & Security

K-Anonymity Protection

Research analytics use k=5 anonymity, meaning data is only shown when at least 5 participants share similar characteristics. This protects individual privacy while enabling meaningful research insights.

Scope-Based Access

Claude can only access data within the scopes you explicitly approve during authorization. You control what data is shared.

Data Retention

  • OAuth access tokens expire after 1 hour
  • Refresh tokens expire after 30 days
  • You can revoke access at any time
  • Claude does not retain your data between sessions

Audit Logging

All data access through the connector is logged for security auditing. You can review access logs in your WeMush account settings.

Examples

Finding and Joining a Research Project

You: "What mycology research projects can I join?"

Claude: Uses list_research_projects to find recruiting projects, then describes options and can enroll you with enroll_in_project.

Recording a Cultivation Observation

You: "My grain jar is 75% colonized, can you record that?"

Claude: Uses list_my_specimens to find your grain spawn, then record_specimen_observation to log the colonization progress.

Getting Cultivation Recommendations

You: "What temperature should I fruit my Blue Oyster block at?"

Claude: Uses search_strains and get_strain_details to find optimal fruiting conditions for Blue Oyster mushrooms.

Troubleshooting

Connection Issues

If you're having trouble connecting:

  1. Ensure you're logged into WeMush in your browser
  2. Clear your browser cookies and try again
  3. Check that pop-ups are allowed for the authorization window

Permission Errors

If Claude reports permission errors:

  1. Disconnect and reconnect the integration
  2. Ensure you approve all requested scopes during authorization
  3. Check that your WeMush account has the required organization membership

Data Not Showing

If your data isn't appearing:

  1. Verify your specimens and projects exist in WeMush
  2. Check that you have at least one organization membership
  3. Some analytics require minimum participation thresholds

Open Source

The WeMush Mycology Assistant skill is open source and available for self-hosting, customization, or contribution.

Repository

  • WeMush Skills Collection: github.com/wemush/wemush-skills
  • Mycology Assistant Skill: wemush-mycology-assistant

Self-Hosting

If you want to run your own instance of the WeMush MCP server:

  1. Clone the repository from GitHub
  2. Follow the setup instructions in the SKILL.md file
  3. Configure your environment variables for your WeMush API credentials
  4. Deploy to your preferred hosting platform

Contributing

We welcome contributions! Whether you want to add new tools, improve existing functionality, or fix bugs:

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request with your changes

See the repository's CONTRIBUTING.md for detailed guidelines.

Support

Need help with the WeMush Claude Connector?

  • Email: support@wemush.com
  • Documentation: wemush.com/docs
  • Status Page: wemush.com/status

For issues specific to Claude AI, visit support.anthropic.com.

Changelog

Version 1.0.0 (January 2026)

Initial Release

  • 33 MCP tools across 6 categories (Research, Observations, Specimens, Analytics, Catalog, Profile)
  • 5 pre-built prompts for common workflows
  • 3 resources for cultivation guidance
  • OAuth 2.0 with PKCE authentication
  • K-anonymity (k=5) privacy protection for analytics
  • SSE and Streamable HTTP transport support
  • Comprehensive scope-based access control
  • Open source release of the WeMush Mycology Assistant skill

Roadmap

  • Enhanced cultivation recommendations with ML models
  • Batch observation imports
  • Research project templates
  • Community strain reviews integration