atheneum-mcp

An MCP (Model Context Protocol) server that connects AI assistants to Wiki.js and Google Drive. Supports multiple Wiki.js instances with path scoping and access controls, plus Google Drive with folder prioritization. Runs as a standalone stdio server, designed to be invoked via npx.

Requires Node.js 24+ (native TypeScript, no build step)

Quick Start

The fastest way to get running with a single Wiki.js instance:

# Set environment variables
export WIKIJS_URL="https://wiki.example.com"
export WIKIJS_TOKEN="your-api-token"

# Run directly
npx atheneum-mcp

Or add it to your MCP client config (see MCP Client Configuration).

YAML Configuration

For multiple wikis, Drive integration, or path scoping, use a YAML config file. The server checks ./atheneum.yaml by default, or pass --config <path> explicitly.

wikis:
  - name: docs
    url: https://wiki.example.com
    token: ${WIKI_TOKEN}
    basePath: /docs
    readOnly: true

  - name: internal
    url: https://internal-wiki.example.com
    token: ${INTERNAL_WIKI_TOKEN}

drive:
  folders:
    - "1abc123def456"
  recursive: true
  strictFolders: false

YAML values support $VAR and ${VAR} interpolation, so you can keep secrets in environment variables or .env files.

See atheneum.example.yaml for a full example with all options.

Google Drive Setup

1. Create OAuth Credentials

1. Go to Google Cloud Console
2. Create a project (or use existing)
3. Enable the Google Drive API
4. Create OAuth 2.0 credentials (Desktop app type)
5. Download the JSON and save it (default location: ~/.config/atheneum-mcp/gcp-oauth.keys.json)

2. Authenticate

npx atheneum-mcp auth

This opens a browser for Google sign-in and saves credentials to ~/.config/atheneum-mcp/tokens.json. Custom paths can be set via YAML config (oauthPath and credentialsPath under drive:).

MCP Client Configuration

Claude Code

Add to your project .mcp.json:

{
    "mcpServers": {
        "atheneum": {
            "command": "npx",
            "args": ["atheneum-mcp", "--config", "./atheneum.yaml"]
        }
    }
}

Or add globally via the CLI:

claude mcp add atheneum -s user -- npx atheneum-mcp --config ~/atheneum.yaml

Simple Setup (env vars only, no YAML)

{
    "mcpServers": {
        "atheneum": {
            "command": "npx",
            "args": ["atheneum-mcp"],
            "env": {
                "WIKIJS_URL": "https://wiki.example.com",
                "WIKIJS_TOKEN": "your-api-token"
            }
        }
    }
}

Configuration Reference

Config Resolution Order

1. --config <path> CLI argument (must exist)
2. ./atheneum.yaml in the current working directory (if present)
3. Environment variable fallback
4. .env file (loaded automatically via dotenv)

Environment Variables (simple mode)

| Variable | Description | |---|---| | WIKIJS_URL | Wiki.js instance URL (creates a single "default" wiki) | | WIKIJS_TOKEN | Wiki.js API token | | GDRIVE_OAUTH_PATH | Path to Google OAuth keys JSON | | GDRIVE_CREDENTIALS_PATH | Path to Google credentials JSON |

YAML: wikis[]

| Key | Type | Default | Description | |---|---|---|---| | name | string | required | Instance name (used in multi-wiki instance parameter) | | url | string | required | Wiki.js base URL | | token | string | required | Wiki.js API token | | basePath | string | / | Restrict operations to a subtree | | readOnly | boolean | false | Disable all write operations | | strictPath | boolean | true | Hard reject paths outside basePath | | hidePaths | boolean | false | Return "not found" instead of "access denied" for out-of-scope paths |

YAML: drive

| Key | Type | Default | Description | |---|---|---|---| | folders | string[] | [] | Folder IDs to prioritize or restrict to | | recursive | boolean | true | Search subfolders of listed folders | | strictFolders | boolean | false | Treat folders as a hard restriction (not just priority hints) | | oauthPath | string | ~/.config/atheneum-mcp/gcp-oauth.keys.json | Path to OAuth client keys | | credentialsPath | string | ~/.config/atheneum-mcp/tokens.json | Path to saved auth tokens |

Wiki Tools

All wiki tools accept an optional instance parameter when multiple wikis are configured.

| Tool | Description | Write | |---|---|---| | search_wiki | Full-text search, results filtered to basePath | No | | get_wiki_page | Get page by path (relative to basePath) | No | | get_wiki_page_by_id | Get page by numeric ID (checked against basePath) | No | | list_wiki_pages | List recent pages under basePath | No | | get_wiki_tree | Folder structure under basePath | No | | list_wiki_tags | All tags (unscoped) | No | | get_pages_by_tag | Pages with tag, filtered to basePath | No | | create_wiki_page | Create page under basePath | Yes | | update_wiki_page | Update page (must be under basePath) | Yes | | delete_wiki_page | Delete page (must be under basePath) | Yes | | move_wiki_page | Move page (source and dest must be under basePath) | Yes |

Drive Tools

| Tool | Description | |---|---| | search_gdrive | Search files with folder prioritization/restriction | | read_gdrive_file | Read file by ID (checked against folders if strict) | | list_gdrive_folder | List folder contents (checked against allowed folders if strict) |

Development

npm install              # Install dependencies
npm start                # Run the server
npm run lint             # Lint code
npm run lint:types       # Type check
npm run release          # Version bump + changelog + tag + push

License

WTFPL