Contextium MCP Server

Model Context Protocol (MCP) server for Contextium - Connect Claude Desktop to your team's documentation, SOPs, coding standards, and AI constraints.

What is Contextium?

Contextium is a central file system for team knowledge that AI assistants can access directly. Store your:

• 📚 Standard Operating Procedures (SOPs)
• 💻 Coding standards and style guides
• 🤖 AI agent configurations
• 🎯 AI constraints and guardrails
• 📖 Skills library (reusable knowledge for agents)
• 🔄 Workflows (pre-configured context sets)

When you connect Claude Desktop via MCP, Claude automatically follows your team's guidelines without manual copy-pasting.

Features

• Direct Integration: Claude Desktop reads your documentation in real-time
• Context Libraries: Organize docs into projects with folders and version control
• AI Agents: Pre-configured assistants with specific skills and knowledge
• Skills Library: Reusable documentation modules that agents can access
• Workflows: Quick-load entire context sets with one command
• Tag-Based Search: Find files by category, status, team, or custom tags
• Version History: Track changes and see who updated what
• Team Collaboration: Multi-workspace support with role-based access

Installation

No installation required! Use `npx` to run commands directly:

```bash npx @contextium/mcp-server@latest setup ```

Or install globally:

```bash npm install -g @contextium/mcp-server ```

Quick Start

1. Authenticate

```bash npx @contextium/mcp-server@latest setup ```

This opens your browser to authorize the MCP server. After authorization, you'll receive an access token that's stored locally.

2. Configure Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json { "mcpServers": { "contextium": { "command": "npx", "args": ["-y", "@contextium/mcp-server@latest"] } } } ```

3. Restart Claude Desktop

After adding the config, restart Claude Desktop. You'll see Contextium tools available in Claude's context.

CLI Commands

Authentication

```bash

Initial setup and authorization

npx @contextium/mcp-server setup

Check authentication status

npx @contextium/mcp-server status

List all profiles

npx @contextium/mcp-server profiles

Switch between profiles

npx @contextium/mcp-server switch

Revoke access token

npx @contextium/mcp-server revoke

Logout (revoke and remove credentials)

npx @contextium/mcp-server logout ```

Browsing Resources

```bash

List workspaces

npx @contextium/mcp-server list-workspaces

List context libraries (documentation projects)

npx @contextium/mcp-server list-projects [workspaceId]

List AI agent configurations

npx @contextium/mcp-server list-agents [workspaceId]

List skills library

npx @contextium/mcp-server list-skills [workspaceId]

List workflows

npx @contextium/mcp-server list-workflows [workspaceId]

List files in a context library

npx @contextium/mcp-server list-files

Get specific file

npx @contextium/mcp-server get-file npx @contextium/mcp-server get-file --content-only npx @contextium/mcp-server get-file --metadata ```

Tag Management

```bash

List all tags

npx @contextium/mcp-server list-tags [workspaceId]

List tags of specific type

npx @contextium/mcp-server list-tags --type

List tag types

npx @contextium/mcp-server list-tag-types [workspaceId]

Find files by tags (AND logic)

npx @contextium/mcp-server list-files-by-tags
--tags tag1,tag2,tag3
--workspace
--project

Create tag type

npx @contextium/mcp-server create-tag-type
--workspace
--name "Priority"
--slug "priority"
--color "#FF5733"

Create tag

npx @contextium/mcp-server create-tag
--workspace
--type
--value "high"
--color "#FF0000" ```

Workflows

```bash

List workflows

npx @contextium/mcp-server list-workflows [workspaceId]

Load workflow (get all tagged files)

npx @contextium/mcp-server load-workflow npx @contextium/mcp-server load-workflow --workspace ```

Search

```bash

Full-text search

npx @contextium/mcp-server search "API documentation" npx @contextium/mcp-server search "API docs" --workspace npx @contextium/mcp-server search "React patterns" --project ```

File Management

```bash

Create file

npx @contextium/mcp-server create-file
--project
--title "API Guidelines"
--path "docs/api.md"
--content "# API Guidelines..."

Update file

npx @contextium/mcp-server update-file
--title "Updated API Guidelines"
--content "$(cat api.md)"

Delete file (moves to trash)

npx @contextium/mcp-server delete-file npx @contextium/mcp-server delete-file --force ```

MCP Tools (For Claude Desktop)

When connected via MCP, Claude has access to these tools:

Core Tools

• `list_projects` - List context libraries (documentation projects)
• `list_agents` - List AI agent configurations
• `list_skills` - List skills library
• `list_files` - List files in a library/agent/skill
• `get_file` - Get file content and metadata
• `search_documentation` - Full-text search across all docs

Advanced Tools

• `list_workflows` - List available workflows
• `load_workflow` - Load all files tagged in a workflow
• `list_tags` - List all tags grouped by type
• `search_by_tags` - Find files matching specific tags (AND logic)
• `get_file_versions` - View version history
• `get_project_structure` - Get folder structure

Write Operations

• `create_file` - Create new file
• `update_file` - Update existing file
• `delete_file` - Delete file (moves to trash)

Usage Examples

Example 1: Load Your Team's Coding Standards

```bash

List your context libraries

npx @contextium/mcp-server list-projects

List files in coding standards library

npx @contextium/mcp-server list-files

Read a specific standard

npx @contextium/mcp-server get-file --content-only ```

Example 2: Use a Workflow

```bash

List available workflows

npx @contextium/mcp-server list-workflows

Load "Frontend Development" workflow (returns all tagged files)

npx @contextium/mcp-server load-workflow ```

Example 3: Find Files by Tags

```bash

List available tags

npx @contextium/mcp-server list-tags

Find all files tagged with "api" AND "active"

npx @contextium/mcp-server list-files-by-tags --tags , ```

Example 4: With Claude Desktop

Once configured, simply chat with Claude:

``` "Load our React coding standards and review this component for compliance"

"Find all API documentation files and summarize the authentication flow"

"Load the Frontend Development workflow and help me set up a new component" ```

Claude will automatically use the MCP tools to access your documentation.

Multi-Profile Support

Work with multiple Contextium accounts or environments:

```bash

Setup additional profile

npx @contextium/mcp-server setup --profile staging

List profiles

npx @contextium/mcp-server profiles

Switch profiles

npx @contextium/mcp-server switch staging

Check current profile

npx @contextium/mcp-server status ```

Configuration

Credentials are stored in `~/.contextium/credentials.json`:

```json { "profiles": { "default": { "name": "default", "accessToken": "...", "apiUrl": "https://api.contextium.io/api/v1", "workspaceId": "...", "isActive": true } } } ```

Security

• Access tokens are stored locally in `~/.contextium/`
• Tokens can be revoked at any time via `revoke` or `logout` commands
• Manage token permissions in your Contextium workspace settings
• Tokens respect your workspace role (owner, admin, editor, viewer)

Troubleshooting

"Not authenticated" error

```bash npx @contextium/mcp-server status npx @contextium/mcp-server setup ```

Claude Desktop not seeing tools

1. Check config file syntax: `~/Library/Application Support/Claude/claude_desktop_config.json`
2. Ensure you used `npx` with `-y` flag
3. Restart Claude Desktop completely
4. Check logs: `~/Library/Logs/Claude/mcp*.log`

"API request timed out" error

• Check your internet connection
• Verify API status at https://status.contextium.io
• Check if your token is still valid: `npx @contextium/mcp-server status`

Links

• Website: https://contextium.io
• Documentation: https://contextium.io/docs/mcp-integration
• GitHub: https://github.com/tomjutla/contextium
• Support: [email protected]

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT © Contextium

Built with Model Context Protocol by Anthropic