MCP Server

Connect AI assistants to your users' data

Give Claude, Cursor, ChatGPT, and other AI tools direct access to your users' Gmail, Slack, and Calendar through the Model Context Protocol. Zero custom code required.

View on npm Quickstart Guide

Setup

Choose your AI client to get started. HTTP transport handles authentication automatically via OAuth 2.1; stdio transport uses environment variables.

HTTP Transport — Claude Desktop connects to the remote MCP server. Authentication is handled automatically via OAuth 2.1. No API key required in the config.

claude_desktop_config.json

{
  "mcpServers": {
    "attrove": {
      "type": "streamable-http",
      "url": "https://api.attrove.com/mcp"
    }
  }
}

HTTP Transport — ChatGPT connects to the remote MCP server. Authentication is handled automatically via OAuth 2.1. No API key required in the config.

ChatGPT MCP Config

{
  "mcpServers": {
    "attrove": {
      "type": "streamable-http",
      "url": "https://api.attrove.com/mcp"
    }
  }
}

stdio Transport — Cursor runs the MCP server locally via npx. You need to provide your API key and user ID as environment variables.

.cursor/mcp.json

{
  "mcpServers": {
    "attrove": {
      "command": "npx",
      "args": ["-y", "@attrove/mcp@latest"],
      "env": {
        "ATTROVE_SECRET_KEY": "sk_...",
        "ATTROVE_USER_ID": "your-user-id"
      }
    }
  }
}

stdio Transport — Claude Code runs the MCP server locally via npx. You need to provide your API key and user ID as environment variables.

Terminal

claude mcp add attrove -- npx -y @attrove/mcp@latest

Then set environment variables in your shell:

Environment

export ATTROVE_SECRET_KEY="sk_..."
export ATTROVE_USER_ID="your-user-id"

Environment Variables

Required for stdio transport (Cursor, Claude Code). HTTP transport handles authentication via OAuth 2.1 automatically.

Variable	Description	Notes
`ATTROVE_SECRET_KEY`	Your Attrove API key	Required Secret Starts with `sk_`
`ATTROVE_USER_ID`	User ID to scope API calls	Required UUID from user provisioning

Tool Reference

Five tools are available to AI assistants. All tools are read-only and only access data the user has explicitly connected.

attrove_query

Ask Attrove

Ask a question and get an AI-generated answer from the user's connected accounts (Gmail, Slack, Calendar). Returns answers with optional source citations.

Parameter	Type	Description
`query` Required	string	The question to ask about the user's context
`integration_ids` Optional	string[]	Filter to specific integration IDs (int_xxx)
`include_sources` Optional	boolean	Include source snippets in the response (default: false)

"What did Sarah say about the Q4 budget?" "Summarize my meeting with the engineering team" "What context do I need for my 3pm meeting?"

attrove_search

Search Messages

Semantic search across the user's connected services. Returns matching messages grouped by conversation without AI summarization.

Parameter	Type	Description
`query` Required	string	The search query (semantic, not keyword-based)
`after_date` Optional	string	Only include messages after this date (YYYY-MM-DD)
`before_date` Optional	string	Only include messages before this date (YYYY-MM-DD)
`sender_domains` Optional	string[]	Filter by sender email domains (e.g., ["acme.com"])
`include_body_text` Optional	boolean	Include message body text preview, truncated to 200 chars (default: true)

"Find all emails about the product launch" "Show me conversations with the marketing team" "Search for messages mentioning the deadline"

attrove_events

Calendar Events

List calendar events from connected calendar accounts (e.g., Google Calendar). Returns event details including attendees, location, and meeting links.

Parameter	Type	Description
`start_date` Optional	string	Start of date range (YYYY-MM-DD)
`end_date` Optional	string	End of date range (YYYY-MM-DD)
`limit` Optional	number	Max events to return (default: 25, max: 100)

"What's on my calendar today?" "Do I have any meetings tomorrow?" "What's my schedule for Friday?"

attrove_meetings

Meeting Summaries

List meetings with AI-generated summaries and action items from connected meeting platforms (Google Meet, Zoom, Teams).

Parameter	Type	Description
`start_date` Optional	string	Start of date range (YYYY-MM-DD)
`end_date` Optional	string	End of date range (YYYY-MM-DD)
`provider` Optional	string	Filter by provider: `google_meet`, `zoom`, or `teams`
`limit` Optional	number	Max meetings to return (default: 10, max: 50)

"What happened in my last meeting?" "Summarize yesterday's standup" "What are the action items from the product review?"

attrove_integrations

List Integrations

List the user's connected integrations and their current status. Useful for checking what data sources are available before running queries.

Parameter	Type	Description
No parameters required

Returns integration ID, provider name (gmail, slack, google_calendar, etc.), and connection status (connected, disconnected, expired, error, pending).

Resources

@attrove/mcp on npm @attrove/sdk on npm API Reference Quickstart Guide Dashboard GitHub