Claude 60-Second Setup

Getting Started Video:

In this video I walk through the set-up steps that are also documented below.

Please note that if you're using the Teams or Enterprise versions there is a slight modification of the "Add Integration" step detailed in the first section below.

Claude Paid Users

Grain MCP supports easy setup as a native Claude Integration.

Step 1: Integration Setup

  1. Navigate to Settings → Integrations (Pro/Max Users) → Organization Settings (Team/Enterprise Users)

Screenshot 2025-06-16 at 3.14.59 PM.png

  1. Click "+ Add Integration"

Screenshot 2025-06-16 at 3.14.00 PM.png

  1. Enter details and click the "Add" button:

Screenshot 2025-06-16 at 3.12.05 PM.png

Step 2: Connection / Authentication

From Settings → Integrations:

  1. Look for "Grain" in the list of integrations and click "Connect"

Screenshot 2025-06-16 at 2.55.12 PM.png

  1. Once automatically redirected to Grain, click "Approve"

Screenshot 2025-06-16 at 2.46.17 PM.png

Step 3: Testing MCP Tools

From a New Claude chat:

  1. Click "Search and Tools" and confirm you can see "Grain" in the list

Screenshot 2025-06-16 at 2.56.06 PM.png

  1. Click "Grain" to confirm the MCP tools are active, toggle tools on/off as desired

Screenshot 2025-06-16 at 2.57.26 PM.png

  1. Test Connection by typing "Tell me about my most recent Grain meeting" or any other test prompt and Submit the chat

Screenshot 2025-06-16 at 3.01.33 PM.png

If everything is set up properly, you'll see Claude make requests to the available Grain tools that are needed to fulfill the data needs of the Chat request. For best results, turn off non-Grain tools that may distract or confuse the LLM or cite the name and filters of the Grain tool you want it to use from the Available MCP Tools section.

Claude Free Users & Other Clients (Developers Only)

Cursor

Click Here to Install

Manual Configuration (All Other Clients)

Prerequisites:

  • Node.js installed (nodejs.org)
  • Claude Desktop App

Verify Node.js Installation:

Open terminal/command prompt and run:

node --version

If you get an error, install Node.js from nodejs.org.

Setup Steps:

  1. Edit Config File

    • Settings → Developer → Edit Config
    • Opens claude_desktop_config.json
  2. Add Configuration

    {
      "mcpServers": {
        "grain": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://api.grain.com/_/mcp"]
        }
      }
    }
  3. Restart Application

    • Close and reopen Claude Desktop
    • Verify "Grain" appears in Settings → Integrations
  4. Enable Tools

    • Select Tools and Settings for Grain
    • Verify all tools are enabled
    • Allow tools when prompted in conversations

Test Connection:

List my recent Grain meetings

Personal Access Token (Developers Only)

Any MCP client that can send custom headers can connect with a Personal Access Token instead of OAuth. This is useful for headless agents, scripts and CI, where there is no browser to complete the OAuth sign-in.

  1. Generate a token from the integrations page.

  2. Point your client at https://api.grain.com/_/mcp and send the token in the Authorization header:

    Authorization: Bearer grain_pat_...

For example, with Claude Code:

claude mcp add --transport http grain https://api.grain.com/_/mcp --header "Authorization: Bearer grain_pat_..."

The token acts as you, with the same access you have in Grain. Treat it like a password, and revoke it from the integrations page if it leaks. Workspace Access Tokens are not accepted by the MCP server.