Zdravo MCP Server

Official Model Context Protocol (MCP) server for Zdravo AI — enabling native "Save to Zdravo" functionality across Claude, ChatGPT, Gemini, and other AI platforms.

🚀 What This Does

The MCP server lets you say "Save to Zdravo" directly inside any AI conversation and have it instantly saved to your Zdravo dashboard — no clicking, no tab switching, no friction.

📦 Installation

Option 1: NPM (Recommended)

npx zdravo-mcp@latest

Option 2: Clone and Run

git clone https://github.com/zdravoai/zdravo-mcp.git
cd zdravo-mcp
npm install
npm start

⚙️ Setup

1. Get Your MCP Token

1. Go to Zdravo AI
2. Sign up / Log in
3. Visit your Dashboard → Settings → Connections
4. Generate your personal API key

2. Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "zdravo": {
      "command": "npx",
      "args": ["zdravo-mcp@latest"],
      "env": {
        "ZDRAVO_API_KEY": "your_token_here"
      }
    }
  }
}

3. Restart Claude

That's it! You'll see "Zdravo" appear in Claude's tools.

🎯 Usage

In Claude Desktop

Simply say any of these phrases:

• "Save to Zdravo"
• "Add this to Zdravo"
• "Remember this in Zdravo"
• "Store in Zdravo"

Claude will automatically:

1. Extract the relevant content from your conversation
2. Save it to your Zdravo dashboard
3. Confirm with a link to view it

Search Your Memories

Ask Claude:

• "What did I save about Python?"
• "Find my notes on debugging"
• "Search my Zdravo memories about React"

🛠️ Available Tools

Personal Memory Tools

save_memory

Saves conversation content to your Zdravo memory bank.

Parameters:

• title (string): Short title for the memory
• content (string): Full content to save
• platform (string): Source platform (claude, chatgpt, gemini, other)
• tags (array): Relevant tags (optional)

search_memories

Searches your saved Zdravo memories using semantic search.

Parameters:

• query (string): Natural language search query
• top_k (number): Number of results (1-20, default 5)
• threshold (number): Similarity threshold 0-1 (default 0.65)
• userId (string): Your user ID

recall

Search your memories using semantic search with local-first ATLAS support.

Parameters:

• query (string): Natural language search query
• limit (number): Number of results (default 5)
• userId (string): Your user ID

get_context

Get relevant context from your memory for the current file and task.

Parameters:

• current_file_path (string): Path to the current file being edited
• current_task (string): Description of the current task or question
• top_k (number): Number of context blocks to return (default 3)
• userId (string): Your user ID

get_user_info

Get your Zdravo account information.

get_user_stats

Get your memory usage statistics.

🔧 Development

Local Development

git clone https://github.com/zdravoai/zdravo-mcp.git
cd zdravo-mcp
npm install
npm run dev

Testing

npm test

🏢 Organization Tools

For teams and enterprise users, use these tools with an organization-scoped API key:

search_org_memories

Search your organization's collective knowledge base for architecture decisions, past solutions, and team context.

save_org_memory

Save decisions, solutions, or insights to your organization's shared knowledge base.

auto_capture (NEW)

Automatically capture and summarize an entire AI session to organizational memory. Use at the end of significant agent sessions.

save_session_summary (NEW)

Persist an entire agent conversation with key decisions and code automatically extracted.

get_constitution

Get your organization's AI memory constitution - standing instructions that guide all AI interactions.

🐛 Troubleshooting

"Zdravo not connected yet!"

• Make sure your ZDRAVO_API_KEY environment variable is set correctly
• Check that you're logged into Zdravo AI
• Generate a new token if needed

Connection Issues

• Ensure you have internet connectivity
• Check that zdravo.ai is accessible
• Verify your token hasn't expired

Claude Desktop Issues

• Make sure you're using Claude Desktop (not claude.ai in browser)
• Check your config file syntax
• Restart Claude after updating config

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

MIT License - see LICENSE file for details.

🔗 Links

• Zdravo AI
• MCP Documentation
• Claude Desktop

Built with ❤️ by the Zdravo AI team