Fastidious MCP Server

MCP (Model Context Protocol) server for Fastidious AI notes application.

Deployment

Environment Variables

Deploy to Coolify

1. Create a new service in Coolify

2. Connect to this repository

3. Set build pack to Nixpacks or Dockerfile

4. Configure environment variable:

   FASTIDIOUS_URL=https://blog.tjb.app

   Or for internal Docker network: FASTIDIOUS_URL=http://fastidious:3000

5. Set the domain to mcp.tjb.app

6. Deploy

Docker

docker build -t fastidious-mcp .
docker run -p 3001:3001 -e FASTIDIOUS_URL=https://blog.tjb.app fastidious-mcp

Related MCP server: Joplin MCP Server

Usage

Claude Desktop Configuration

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

{
  "mcpServers": {
    "fastidious": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tjb.app/sse?token=YOUR_TOKEN_HERE"]
    }
  }
}

Get your token from Fastidious AI Settings (sidebar → profile → Settings).

Note: Uses mcp-remote to proxy the remote SSE connection.

Local Development (stdio mode)

For local testing with Claude Desktop:

{
  "mcpServers": {
    "fastidious": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-server/src/index.ts"],
      "env": {
        "FASTIDIOUS_TOKEN": "YOUR_TOKEN_HERE",
        "FASTIDIOUS_URL": "https://blog.tjb.app"
      }
    }
  }
}

Available Tools

Architecture

Claude Desktop
    ↓ MCP Protocol (SSE)
MCP HTTP Server (mcp.tjb.app)
    ↓ HTTP + Bearer Token
Fastidious API (blog.tjb.app/api/mcp/*)
    ↓
User's Notes & Collections

API Endpoints

• GET /health - Health check

• GET /sse?token=TOKEN - MCP SSE endpoint for Claude Desktop

Internal Network (Docker/Coolify)

If running alongside Fastidious in the same Docker network:

FASTIDIOUS_URL=http://fastidious:3000

This avoids external network hops for better performance.