Kindred MCP Server

MCP (Model Context Protocol) server that exposes Kindred's knowledge workspace to AI assistants like Claude Desktop.

Installation

Via npx (recommended)

npx kindred-mcp-server

Via npm

npm install -g kindred-mcp-server
kindred-mcp

Tools (16 total)

Read Operations

| Tool | Description | Permission | |------|-------------|------------| | search_pages | Keyword search across all pages | pages:read | | semantic_search | Vector similarity search by meaning | pages:read | | get_page | Get full page content by ID | pages:read | | list_pages | List pages with filters (supertag, parent, sort) | pages:read | | get_graph | Query knowledge graph connections | pages:read | | get_backlinks | Get pages that link to a specific page | pages:read | | list_supertags | List all supertags with schemas | pages:read |

Write Operations

| Tool | Description | Permission | |------|-------------|------------| | create_page | Create a new page | pages:write | | update_page | Update page title or content | pages:write | | delete_page | Archive a page (soft delete) | pages:write | | add_supertag | Tag a page with a supertag | pages:write | | remove_supertag | Remove a supertag from a page | pages:write | | create_link | Create [[link]] between pages | pages:write | | create_supertag | Create a new supertag schema | supertags:write |

Agent Operations

| Tool | Description | Permission | |------|-------------|------------| | list_agents | List automated agents in workspace | agents:read | | run_agent | Manually trigger an agent | agents:run |

Setup

1. Create an API key

In Kindred, go to Settings > API Keys and create a new key with appropriate permissions:

• pages:read - Required for all read operations
• pages:write - Required for create/update/delete/tag operations
• supertags:write - Required to create new supertags
• agents:read - Required to list agents
• agents:run - Required to run agents

2. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kindred": {
      "command": "npx",
      "args": ["kindred-mcp-server"],
      "env": {
        "KINDRED_API_KEY": "knd_your_api_key_here",
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/kindred",
        "TYPESENSE_HOST": "localhost",
        "TYPESENSE_PORT": "8108",
        "TYPESENSE_API_KEY": "xyz"
      }
    }
  }
}

3. Restart Claude Desktop

The Kindred tools will now be available in Claude Desktop.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | KINDRED_API_KEY | Yes | API key from Kindred settings | | DATABASE_URL | Yes | PostgreSQL connection string | | TYPESENSE_HOST | No | Typesense host (default: localhost) | | TYPESENSE_PORT | No | Typesense port (default: 8108) | | TYPESENSE_API_KEY | No | Typesense API key | | OPENAI_API_KEY | No | For semantic search embeddings |

Development

cd mcp-server

# Install dependencies
pnpm install

# Type check
pnpm type-check

# Build
pnpm build

# Run directly (for testing)
KINDRED_API_KEY=knd_... DATABASE_URL=... pnpm dev

Example Usage

Once configured, you can ask Claude Desktop:

Search & Read:

• "What pages do I have about meetings?"
• "Find pages similar to my project planning notes"
• "What's linked to my Product Roadmap page?"
• "Show me all pages tagged with #Task"

Create & Organize:

• "Create a new meeting notes page"
• "Tag my latest page with the Project supertag"
• "Link this page to the Product Roadmap"
• "Create a supertag for tracking bugs"

Agents:

• "List my automated agents"
• "Run the Weekly Summary agent"

Claude will use the MCP tools to query and modify your Kindred workspace based on your actual content.

License

MIT